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Multiprogramming with a fixed number of 
tasks is Option 2 of the control program 
for the IBM System/360 Operating System. 
This publication describes the internal 
logic of the control program to the extent 
that it is modified for Option 2. These 
modifications affect the job management, 
task management, and data management rou- 
tines of the control program. 

The Program Logic Manual is to be used 
with the program assembly listings and is 
primarily a guide to those listings. It is 
intended for personnel involved in program 
maintenance and system programmers who are 
altering the system design. Program logic 
information is not necessary for the use 
and operation of the control program; 
therefore, distribution of this document is 
limited to those with the aforementioned 
requirements . 
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PREFACE 



This publication describes the differen- 
ces in internal logic that are introduced 
by the expansion of the control program to 
include Option 2: multiprogramming with a 
fixed number of tasks. It is assumed that 
the reader of this publication is thorough- 
ly familiar with the basic operation of the 
control program. Only areas of difference 
are discussed in detail; however, informa- 
tion on sequential scheduling systems in 
general is included where necessary to 
assist the reader in relating new topics to 
known characteristics of the system. 

The manual is divided into four major 
sections. The first section, the Introduc- 
tion, outlines the function and organiza- 
tion of the entire control program and 
provides references to sources of informa- 
tion on various control program elements. 
The Theory of Operation section describes 
control program flow, with emphasis on job 
management operations, which is the aspect 
of the control program most significantly 
different under Option 2. The Program 
Organization section provides detailed des- 
criptions of added or significantly changed 
routines. The Load Modules and Assembly 
Modules section contains a directory to the 
contents of the nucleus, the SVC library, 
and the link library. 

Information in this document is directed 
to the customer engineer who maintains and 
services IBM System/360 Computing Systems 
and who is responsible for field mainten- 
ance and updating of IBM System/360 Operat- 
ing System. This information may also be 
used by the programming systems maintenance 
programmer and the development programmer 
who will expand the system. 



This publication may be used to locate 
those areas of the system to be analyzed or 
modified. The information is presented to 
enable the reader to relate Option 2 func- 
tions to the program listings (coding) for 
those functions. The comments in the list- 
ings provide information for thorough anal- 
ysis and understanding of the coding. 
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INTRODUCTION 



In a single- task environment main stor- 
age is divided into two areas: the fixed or 
system area, and the processing program 
area. In a multiprogramming environment 
with a fixed number of tasks , the process- 
ing program area is further divided into 
from one to four partitions. Figure 1 
shows the division of main storage for a 
four-partition system. One task uses each 
partition , and all tasks operate concur- 
rently. 



The system area is used for system 
routines that perform control functions 
during the execution of a processing pro- 
gram, and for control blocks and tables 
used by the system for the performance of 
those control functions. Each partition is 
used for a processing program and its data, 
control blocks, and tables. 

Option 2 of the control program provides 
for the concurrent execution of up to four 
jobs, each in its own fixed partition of 
main storage. Each job consists of a 
single task. The Option 2 system provides 
for task switching between the user tasks 
operating in the partitions, and between 
those tasks and the communication task 
(master scheduler) in the system area. 

Jobs are sequentially scheduled in the 
Option 2 system. The job scheduling func- 
tion is unchanged, except that the capabil- 
ity for performing that function in differ- 
ent partitions at different times is added. 

With the Option 2 system, task dispatch- 
ing differs primarily in that task switch- 
ing is required, and that certain system 
functions such as abnormal termination must 



be carried out in such a way that other, 
unrelated tasks are not affected. 

Job and task management functions are 
performed under control program Option 2 
through modified or expanded versions of 
the corresponding routines described in the 
publications IBM System/360 Operating 
System; Job Management, Program Logic Manu- 
al , and IBM System/360 Operating System: 
Fixed-Task Supervisor, Program Logic Manu- 
al . General information on those modifica- 
tions and expansions is provided in this 
publication. 



FUNCTIONS OF THE CONTROL PROGRAM WITH 
OPTION 2 

Control program routines are grouped 
into three functional areas: 

• Job Management routines. 

• Task Management routines. 

• Data Management routines. 



JOB MANAGEMENT ROUTINES 

Job management routines provide communi- 
cation between the user and the operating 
system by: 

• Analyzing the input job stream and 
collecting the information needed to 
prepare a job for execution. 

• Analyzing operator commands, and trans- 
mitting messages from a program to the 
operator. 
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Figure 1. Storage Allocation for a 
Partition System 
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There are four major job management 
routines : 

• Master scheduler, referred to for the 
Option 2 system as the communication 
task, which analyzes commands from the 
console and transmits messages to the 
operator. 

• Reader/interpreter, which reads the 
input job stream and constructs control 
blocks and tables from information in 
the control statements. 

• Initiator/terminator, which collects 
the information and resources needed to 
execute a job step and performs the 
operations reguired to terminate a job 
step. 
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• Scheduler controller, which governs the 
sequence in which operation of the 
reader/interpreter and the initiator/ 
terminator occurs in the system's prob- 
lem program partitions; this function 
is added for the Option 2 system. 

The operation of these routines, to the 
extent that operational differences exist, 
is described in this publication. Opera- 
tions of these routines that are not signi- 
ficantly different in either environment 
are described in the publication IBM 
System/360 Operating System; Job Manage- 
ment # Program Logic Manual . 



TASK MANAGEMENT ROUTINES 

Task management routines monitor and 
control the entire operating system, and 
are used throughout the operation of both 
the control and processing programs. 

There are six functions performed by 
these routines: 

• Interruption handling 

• Task supervision 

• Main storage supervision 

• Contents supervision (and program 
fetch) 

• Overlay supervision 

• Time supervision 

The task management routines are collec- 
tively referred to as the "supervisor." Of 
these functions, all are identical for 
either environment except for task supervi- 
sion, changes to which are discussed in 
this publication. A description of all 
task management routines is given in the 
publication IBM System/360 Operating Sys- 
tem: Fixed-Task Supervisor, Program Logic 
Manual . 



DATA MANAGEMENT ROUTINES 

Data management routines control all 
operations associated with input/output 
devices: allocation of space on volumes, 
channel scheduling, storing, naming, and 
cataloging of data sets, movement of data 
between main and auxiliary storage, and 
handling of errors that occur during I/O 
operations. Data management routines are 
used both by problem programs and by con- 
trol program routines that require data 
movement. Problem programs use data man- 
agement routines primarily to read and 
write data. The control program uses data 
management routines not only to read and 



write required data, but also to locate 
input data sets and to reserve auxiliary 
storage space for output data sets of the 
problem programs. 

There are five categories of data man- 
agement routines: 

• Input/output (I/O) supervisor, which 
performs I/O operations and processes 
I/O interruptions. 

• Access methods, which communicate with 
the I/O supervisor. 

• Catalog management, which maintains the 
catalog and locates data sets on auxil- 
iary storage. 

• Direct-access device space management 
(DADSM) , which allocates auxiliary 
storage space. 

• Open/Close/End-of -Volume , which per- 
forms required initialization for I/O 
operations and handles end-of -volume 
conditions . 

Of these routines, the only category 
affected by the selection of control pro- 
gram Option 2 is DADSM. All other data 
management routines operate identically 
with or without Option 2. The differences 
in DADSM operation are summarized in the 
"Program Organization" section of this pub- 
lication. The operation of all data man- 
agement routines is described in the fol- 
lowing publications: 

IBM System/360 Operating System: 

Input/Output Supervisory Program 
Logic Manual ; Form Y28-6616 

IBM System/360 Operating System: Sequen- 
tial Access Methods, Program Logic 
Manual ; Form Y28-6604 

IBM System/360 Operating System: Basic 
Direct Access Method # Program Logic 
Manual; Form Y28-6617 

IBM System/360 Operating System: Catalog 
Management, Program Logic Manual ; 
Form Y28-6606 

IBM System/360 Operating System: Direct 
Access Device Space Management, Pro- 
gram Logic Manual ; Form Y28-6607 

IBM System/360 Operating System: 
Input/Output Support 

(OPEN/CLOSE/EOV) . Program Logic Manu- 
al , Form Y28-6609 



ORGANIZATION OF THE CONTROL PROGRAM 

Different portions of the control pro- 
gram operate from different areas of main 
storage. The fixed (system) area of main 
storage is the lower portion of main stor- 
age; its size is determined by the control 
program configuration. The system area 



contains those control program routines 
that perform a system function during the 
execution of a processing program. 

The problem program area is the upper 
portion of main storage. It is defined at 
system generation as containing from two to 
four partitions; the number of partitions 
may be reduced and the size of each may be 
redefined at nucleus initialization, but is 
fixed thereafter until another initial pro- 
gram loading (IPL) is performed. Each 
partition may be occupied by a processing 
program , or by control program routines 
that either prepare job steps for execution 
(i.e. r job management routines) , or handle 
data for a processing program (i.e., the 
access methods) . 

On auxiliary storage, the control pro- 
gram resides in three partitioned data sets 
that are created when the operating system 
is generated. These data sets are: 

• The NUCLEUS partitioned data set 
(SYS1. NUCLEUS), which contains the 
resident portion of the control program 
and the nucleus initialization program. 

• The SVCLIB partitioned data set 
(SYS1.SVCLIB) , which contains the non- 
resident SVC routines, nonresident 
error handling routines, and the access 
method routines. 

• The LINKLIB partitioned data set 
(SYS1.LINKLIB), which contains the 
other nonresident control program rou- 
tines and the IBM-supplied processing 
programs . 

Figure 2 shows the main storage areas 
into which the routines from each parti- 
tioned data set are loaded. 



RESIDENT PORTION OF THE CONTROL PROGRAM 

The resident portion (nucleus) of the 
control program resides in the NUCLEUS 
partitioned data set. This portion of the 
control program is made up of those rou- 
tines, control blocks, and tables that are 
brought into main storage at IPL and that 
are never overlaid by another part of the 
operating system. The nucleus is loaded 
into the system area of main storage. 

The resident task management routines 
are: all of the routines that perform 
interruption handling, main storage super- 
vision, and time supervision; and some of 
the routines that perform task supervision, 
contents supervision, and overlay supervi- 
sion. These routines are described in this 
publication and in the publication IBM 
System/360 Operating System: Fixed-Task 
Supervisor , Program Logic Manual . 



Resident for job management are those 
portions of the communication task that 
receive commands from the operator. The 
communication task is described in this 
publication. 

The resident data management routines 
are the input/output supervisor and the 
BLDL routines, which are part of the parti- 
tioned access method. These routines are 
described in the publications IBM 
System/360 Operating System: Input/Output 
Supervisor, Program Logic Manual and IBM 
System/360 Operating System: Sequential 
Access Methods , Program Logic Manual . 



NONRESIDENT PORTION OF THE CONTROL PROGRAM 

The nonresident portion of the control 
program is made up of those routines that 
are loaded into main storage as they are 
needed, and can be overlaid after their 
completion. The nonresident routines oper- 
ate from the partitions and from two sec- 
tions of the system area called transient 
areas . 

TRANSIENT AREAS: The transient areas are 
two blocks of main storage defined in the 
nucleus and embedded in the system area. 
The first, the SVC transient area, is 
reserved for nonresident SVC routines. The 
second, the I/O supervisor transient area, 
is used by nonresident I/O error handling 
routines that are brought in by the I/O 
supervisor. Each transient area contains 
only one routine at a time. When a nonres- 
ident SVC or error handling routine is 
required, it is read into the appropriate 
transient area. All routines read into the 
transient areas reside in SYS1. SVCLIB. 

PARTITIONS: Each partition may be used for 
a processing program as well as for the 
access method routines and the nonresident 
job management routines of the control 
program. When the control program needs 
main storage to build control blocks or for 
a work area, it obtains this space from the 
partition in which the processing program 
that caused the requirement to arise was 
operating . 

Access method routines are brought into 
each partition from SYS1. SVCLIB. Job man- 
agement routines are brought in from 
SYS1. LINKLIB. Processing programs are 
brought in from either SYS1. LINKLIB, or a 
user- specified partitioned data set. 

The program area is subdivided as shown 
in Figure 2. Job management routines, 
processing programs, and routines brought 
into storage via a LINK or XCTL macro- 
instruction are loaded into the lowest 
available portion of a partition. The 
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Division of Main Storage for the Operating System 



highest portion of a partition is occupied 
by a table (the task input/output table) 
built by a job management routine. This 
table is used by data management routines 
and contains information about DD 
statements. It remains in storage for the 
whole job step. Access method routines and 
routines brought into storage via a LOAD 
macro- instruction are placed in the highest 
available locations in a partition. 



SYSTEM ENVIRONMENT 

MACHINE TYPES 

The control program with Option 2 is 
designed for use with IBM System/360 9 Model 
30 or higher. A two- partition system using 
the 18K scheduler (where K is equal to 1024 
bytes) will operate in a configuration 
having a 64K byte main storage capacity; a 
system having more partitions and/or using 
the U4K scheduler requires additional main 
storage. 



MINIMUM REQUIRED CONFIGURATION 

Selection of Option 2 does not affect 
the minimum required configuration. 
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THEORY OF OPERATION 



PROGRAM FLOW 

The stages of program execution under 
the Option 2 system of the IBM System/360 
Operating System are: 



0. 



Loading 
(IPL). 



the nucleus into main storage 



1. Reading control statements, 

2. Initiating a job step, 

3. Executing a job step f and (optionally) 
activating a lower- priority partition. 

4. Terminating a job step, and (option- 
ally) preparing for job scheduling in 
a higher-priority partition. 

The operating system is given control of 
the computer when the control program 
nucleus is loaded. Thereafter, jobs may be 
processed without reloading the nucleus. 

When the user introduces a job into the 
input stream, the initial processing 
required to prepare his job for execution 
is performed by job management routines. 
Control statements for a complete job are 
read during stage 1. 

Stage 2 is the processing required to 
initiate the execution of a user's job 
step. Stage 3 occurs when CPU control is 
passed to that job step. 

Up to this point, only one partition has 
been active. During stage 3 the problem 
program can cause another partition to 
become active; stages 1, 2, and 3 then 
proceed in that partition. This process 
can be repeated in each partition until all 
are active, with job step execution pro- 
ceeding concurrently in each partition. 

The Control Program with Option 2 is 
designed to operate with single- step, 
unending jobs in all partitions except the 
partition of lowest priority. In that 
configuration, step and job termination 
normally occur only in the lowest- priority 
partition. When a program enters stage 4, 
job management routines perform termination 
procedures for the step (and, when applica- 
ble, for the job) . 

Upon completion of a job, control passes 
back to stage 1. If further job step 
control statements had been read during 
stage 1, control passes to the initiation 
of the next job step (stage 2) . 

The user can, through a system command 
(SHIFT) , reverse the process through which 
successive partitions are made active. 
When stage 4 is complete in a partition, 
stage 1 will normally proceed in the same 



partition; however, the user can cause the 
partition from which the terminating parti- 
tion was originally activated, rather than 
the terminating partition itself, to be the 
next partition in which stage 1 is to 
proceed. 



When termination is complete for all 
jobs in the system and there are no further 
jobs in the input job stream, the control 
program places the CPU in the wait state. 
As long as the nucleus remains intact in 
main storage, the user can introduce new 
jobs into the job stream without reloading 
the nucleus. 



Reading control statements and initiat- 
ing a job step are performed by the 
reader/interpreter and the initiator/ter- 
minator routines, respectively. Descrip- 
tions of these routines are given in the 
publication IBM System/360 Operating Sys- 
tem: Job Management, Program Logic Manual . 

A job step is performed by a user- 
written program (e.g., a payroll program), 
or an IBM-supplied processing program 
(e.g., linkage editor, COBOL). 

Terminating a job step is performed by 
the initiator/terminator and the super- 
visor. Terminator functions peculiar to 
the Option 2 system are discussed in the 
"Job Management " section of this 
publication. Descriptions of these rou- 
tines applicable to either environment are 
given in the publications IBM System/360 
Operating System: Job Management, Program 
Logic Manual , and IBM System/360 Operating 
System: Fixed-Task Supervisor, Program 
Logic Manual . 

The routines through which successive 
partitions are activated during problem 
program execution and relinquish control 
after termination are described in the "Job 
Management" section of this publication. 

Figure 3 describes the overall flow of 
CPU control through the job processing 
cycle. These paragraphs describe the pro- 
cessing performed by various components of 
the control program as it loads the 
nucleus, reads control statements, ini- 
tiates the job step, causes processing to 
begin or end in successive partitions, and 
terminates the job step. Control program 
processing performed during the execution 
of a job step, including control flow to 
the control program, control flow to a 
processing program, and input/ out put con- 
trol, is unchanged under the Option 2 
system. For a discussion of those topics, 
refer to the publication IBM System/360 
Operating System: Introduction to Control 
Program Logic, Program Logic Manual . 



10 



c 



IPL 



D 



Load 

IPL 

Program 



IPL 



Load 
Nucleus 



Initialize 
Nucleus 



SUPERVISOR 



Bring 

Reader/Interpreter 

and Part of 

Communications 

Task 

into Current 

Partition 



COMMUNICATIONS 
TASK 



Interpret 
Commands 



READER/INTERPRETER 



Read and Interpret 
Control Statements 

Build Tables 




START READER 
START WRITER 
SET 



EXEC 



JOB 



E> 



SUPERVISOR 



Bring 

Initiator/ 

Terminator 

into Partition 



To load the nucleus, the operator speci- 
fies the device on which the system resi- 
dence volume is mounted, and presses the 
load button on the console. This action 
causes an IPL record to be read and to be 
given CPU control. This record reads a 
second IPL record which, in turn, reads the 
rest of the IPL program into main storage. 

The IPL program searches the volume 
label to locate the volume table of con- 
tents (VTOC) of the system residence vol- 
ume. The volume table of contents is then 
searched for the SYS1. NUCLEUS. The nucleus 
is brought into the system area, and the 
nucleus initialization program (NIP) is 
brought into the dynamic area. NIP 
receives CPU control from the IPL program, 
and initializes the nucleus. Nucleus ini- 
tialization includes initializing the con- 
trol blocks that establish the absolute 
location and extent of each partition with- 
in the processing program area; communi- 
cation between the operator and the system 
provides for the redefinition, if desired, 
of the partitions to be used. After com- 
pleting its processing, NIP causes the 
reader/interpreter to be brought into the 
highest-priority partition in the problem 
program area. (NIP remains in main stor- 
age, but is not re-entered. It may or may 
not be overlayed as successive partitions 

When the start reader (START RDR) , start 
writer (START WTR) , and set date (SET) 
commands are issued, the resulting inter- 
ruption causes CPU control to be given to 
the master command routine. After process- 
ing the commands, this communication task 
routine passes CPU control to the 
reader/interpreter. The reader/interpreter 
is described in the publication IBM 
System/360 Operating System: Job Manage- 
ment, Program Logic Manual . Changes to the 
communication task that, in the Option 2 
system, replaces the master scheduler are 
described below. 

The reader/interpreter reads the control 
statements from the input job stream. 
Information from the JOB, EXEC, and DD 
statements is used to control the execution 
of job steps. This information is used to 
construct a job control table (JCT) for the 
job being read, a step control table (SCT) 
for the job step being read, and a job file 
control block (JFCB) and step input/output 
table (SIOT) for each data set being used 
or created by the job step. Information 
from these tables and control blocks is 
combined with information in the data con- 
trol block (DCB) and data set control block 
(DSCB) or label when a data set is opened 
during step execution. 



Figure 



Example of CPU Control Flow for a Job Processing Cycle (Sheet 1 of 4) 
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The reader/interpreter is itself re- 
placed in the highest- priority partition by 
the initiator /terminator routine. 

After receiving CPU control, the 
initiator/terminator prepares to initiate 
the job step that has been read and inter- 
preted- Using the data which the 
reader/interpreter extracted from the DD 
statements, the initiator /terminator: 

Locates Input Data Sets : The initiator/ 
terminator determines the volume containing 
a given input data set from the data 
definition (DD) statement, or from a search 
of the catalog. This search is performed 
by a catalog management routine that is 
entered from the initiator /terminator. A 
description of the routines that maintain 
and search the catalog is given in the 
publication IBM System/360 Operating Sys- 
tem: Catalog Management, Program Logic 
Manual . 

Assigns I/O Devices : A job step cannot be 
initiated unless there are enough I/O de- 
vices to fill its needs. The initiator/ 
terminator determines whether the required 
devices are available, and makes specific 
assignments. If necessary, messages to the 
operator direct the mounting of volumes 
(tapes, etc.). 

Allocates Auxiliary Storage Space : Direct 
access volume space required for output 
data sets of a job step is acquired by the 
initiator/terminator, which uses DADSM. A 
description of the operation of DADSM is 
given in the publication IBM System/360 
Operating System: Direct Access Space Man- 
agement , Program Logic Manual . 



The JFCB, which contains information 
concerning the data sets to be used during 
step execution, is written on auxiliary 
storage. This data is used when a data set 
is opened, and when the job step is termi- 
nated (e.g., disposition). 



The initiator/terminator causes itself 
to be replaced by the problem program to be 
executed. 



The processing program can be one of the 
IBM-supplied processors (e.g., COBOL, link- 
age editor) , or a user-written program. 
The processing program uses control program 
services for operations such as loading 
other programs and performing I/O opera- 
tions . 
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Initiation of operations in another par- 
tition begins when a WAITR macro- 
instruction is issued in the processing 
program. When a WAITR is encountered, 
control passes to the scheduler controller, 
which is resident in the nucleus. That 
routine restructures the system job queue 
a way that information related to 
which the WAITR was 
a new area, to be used 
in connection with the partition now to be 
activated, is available to the reader/ 
interpreter. Control then returns to the 
supervisor. 



After a WAITR has been processed, both 
the partition in which the macro- 
instruction was issued and the next-lower- 
priority partition contain tasks that are 
potentially dispatchable. (The communica- 
tion task is always potentially 
dispatchable, and is of higher priority 
than any partition-related task. ) When the 
supervisor is re-entered, the task dis- 
patcher dispatches the ready task of 
highest priority; therefore, processing 
continues in the partition from which the 
WAITR was issued until a Wait condition is 
entered in that partition. A Wait causes 
the next-lower- priority-partition's task to 
be dispatched. This causes the reader/ 
interpreter to be brought into the lower- 
priority partition and to receive control. 
The reader/interpreter proceeds as describ- 
ed above, exactly as though the new job 
were the first to have been read after IPL 
or START; however, the reader/interpreter 
is now working with a different portion of 
the system job queue and in a different 
segment of main storage. 



When a processing program terminates, 
the supervisor receives CPU control. The 
supervisor uses the OPEN/CLOSE/ EOV routines 
to close any open data control blocks. 
These routines are described in the 
publication IBM System/360 Operating Sys- 
tem: Input/Output Support ( OPEN/CLOSE/ EOV ) . 



Program Logic Manual. 



Under abnormal termination conditions, 
the supervisor may also provide special 
termination procedures such as a storage 
dump. 



Figure 



Example of CPU Control Flow for a Job Processing Cycle (Sheet 3 of 4) 
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The supervisor passes control to the 
initiator/terminator, which is brought into 
the partition in which termination is to 
occur. The initiator/terminator determines 
whether the scheduler is currently asso- 
ciated with the partition; if not f the task 
in the terminating partition must WAIT 
until the scheduler has been re-associated 
with the partition. 



When the scheduler is again available, 
the initiator/terminator performs the func- 
tions required to terminate individual job 
steps and complete jobs. It executes an 
installation accounting routine if one if 
provided. 



The initiator /terminator releases the 
I/O devices, and disposes of data sets used 
and/or created during the job step. (This 
requires reading tables prepared during 
initiation. Some of these tables are part 
of the system job queue. It is for this 
reason that termination cannot proceed 
until the scheduler has again been asso- 
ciated with the terminating partition — 
that is, until the portion of the job queue 
containing information for the terminating 
partition has again become the apparent 
"single" job queue for the system.) 



If the control statements for the next 
job step were read and interpreted, the 
initiator/terminator initiates that step. 
If the statements were not read, the 
initiator/terminator determines whether a 
shift operation is pending. (A shift oper- 
ation is pending when a SHIFT command has 
been entered by the operator or encountered 
in the job stream and has not been fully 
effected.) If no shift is outstanding, the 
initiator/terminator is replaced in the 
same partition with the reader/interpreter, 
which starts, the read-initiate- execute- 
terminate cycle for the next job. If a 
shift is outstanding, the initiator trans- 
fers control to the scheduler controller, 
which reverses the previous restructuring 
of the job queue so that the effective job 
queue is associated with the next-higher- 
priority partition. The scheduler control- 
ler then causes the reader/interpreter to 
be brought not into the partition that just 
terminated, but into the next-higher- 
priority partition; the 
read- initiate- execute- terminate cycle then 
begins in that higher- priority partition. 



Figure 3. Example of CPU Control Flow for a Job Processing Cycle (Sheet 4 of 4) 



14 



JOB MANAGEMENT 

Job management (Chart 1) is the first 
and last portion of the control program 
that a job encounters. Its primary 
function is to prepare job steps for execu- 
tion and, when they have been executed, to 
direct the disposition of data sets created 
during execution. Prior to step execution, 
job management: 



• Reads control statements from the input 
job stream. 

• Places information contained in the 
statements into a series of tables. 



the publication IBM System/360 Operating 
System: Job Management, Program Logic Manu- 
al. 

When the job step has been executed, 
control is again given to the initiator/ 
terminator which, when the scheduler is 
assigned to the partition in which the job 
step has executed, performs data set dispo- 
sitions and releases I/O resources. The 
shift count is interrogated, at job termi- 
nation, to determine if the scheduler is to 
be shifted into a higher priority parti- 
tion. 



• Analyzes input/output (I/O) reguire- 
ments . 

• Assigns I/O devices. 

• Passes control to the job step. 

Following step execution, job manage- 
ment : 

• Releases main storage space occupied by 
the tables. 

• Frees I/O devices assigned to the step. 

• Disposes of data sets referred to or 
created during execution. 

Job management also performs all pro- 
cessing reguired for communication between 
the operator and the control program. 
Major components of job management are the 
job scheduler, which introduces each job 
step to System/360, and the communication 
task, which handles all operator- system 
commun i cat ion . 



JOB SCHEDULER FUNCTIONS 

The job scheduler includes three pro- 
grams: the reader/interpreter, the 
initiator/terminator and the scheduler 
controller. The functions of the reader/ 
interpreter are unchanged from the seguen- 
tial scheduling system; for further infor- 
mation, refer to the publication IBM 
System/360 Operating System: Job Manage- 
ment y Program Logic Manual . 

After all control statements for a job 
have been processed, or when data is 
encountered in the input job stream, the 
reader/interpreter gives control to the 
initiator/terminator. The initiator por- 
tion of the initiator/terminator function 
is unchanged from the seguential scheduling 
system; for further information, refer to 



COMMUNICATION TASK FUNCTIONS 

The routines of the communication task 
process the following types of communi- 
cation between the operator and the system. 

• Operator commands, whether they are 
issued through the console or through 
the input job stream. 

• Write- to- operator (WTO) and write-to- 
operator with reply (WTOR) macro- 
instructions . 

• Interruptions caused when the INTERRUPT 
key is pressed. 



JOB PROCESSING 

Figure 4 shows the major components of 
job management and illustrates the general 
flow of control. 

Control is passed to job management 
whenever the supervisor finds that there 
are no program reguest blocks in the 
reguest block gueue. This can occur for 
two reasons: either the initial program 
loading (IPL) procedure has just been com- 
pleted or a job step has just been execut- 
ed. 



Entry to Job Management Following Initial 
Program Loading 

Following IPL, certain actions must be 
taken by the operator before job processing 
can begin. Therefore, control passes to 
the communication task and a message is 
issued to the operator instructing him to 
enter commands. These "initialization" 
commands include a SET command, a start 
writer (START WTR) command, and a start 
reader (START RDR) command. When a START 
command with a blank operand is issued, 
control is passed to the reader/inter- 
preter. 
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****A2********* 

* * 

* ENTRY * 

* * 
*************** 



**** A3** ******* 

* * 

* ENTRY * 

* * 
*************** 



*****B1 ********** 

* * 

* PROCESS * 
♦INITIALIZATION *X. 

* COMMANDS * 

* * 
***************** 



*****B2********** 



***************** 



•IS SCHEDULER*. 

*. ASSIGNED TO • 

THIS PARTITION 



*****C2********** 



***************** 



****C3 ********* 

* * 

* WAIT * 

* * 
*************** 



*****C4********** 

* DO POST-STEP * 

* HOUSEKEEPING, * 
♦EXECUTE USER'S * 

* ACCOUNTING * 

* ROUTINE * 
***************** 



-♦.SHIFT PENDING. *X. 



*****E4********** 

* DO POST-JOB * 

* HOUSEKEEPING, * 
.♦EXECUTE USER'S ♦ 

* ACCOUNTING * 

* ROUTINE * 
***************** 



*****F3** ******** 

* ASGN * 

* SCHEDULER TO * 
.* NEXT-HIGHER- * 

* PRIORITY ♦ 

* PARTITION * 
***************** 



*****G2********** 

* READ AND * 

* PROCESS JOB * 

* CONTROL ♦X 

* STATEMENTS * 

* * 
***************** 



*****H1 ********** 

* * 

* REQUEST * 

* AND PROCESS *X 

* COMMANDS ♦ 

* * 
***************** 



*****J4********** 

* INITIALIZE * 

* TABLES FOR ♦ 
♦STEP. ALLOCATE * 

* I/O DEVICES * 

* * 
***************** 



*****K3********** 

♦ ON WAITR, * 
♦ASGN SCHEDULER ♦ 

.♦TO NEXT-LOWER- ♦X 

♦ PRIORITY PTN ♦ 

♦ ♦ 
***************** 



****K4********* 

* EXIT TO * 

* PROCESSING ♦ 

* PROGRAM * 
*************** 



Figure 4. Job Management Logic 
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Entry to Job Management Following Step 
Execution 

Following step execution, control is 
routed to the step termination routine of 
the initiator/terminator. If the job had 
been completed, control is also passed to 
the job termination routine of the 
initiator/terminator. Both routines are 
described under "Job and Step Termination." 



Control Statement Processing 

After completion of the processing that 
immediately follows IPL, or after termina- 
tion of a job or of a step containing data 
in the input job stream, control is passed 
to the reader/interpreter. The reader/ 
interpreter reads and processes control 
statements until one of the following con- 
ditions is encountered: 

• A DD * or DD DATA statement. 

• Another JOB statement. 

• A null statement. 

• An end-of-data set (EOF) on the system 
input device. 

Meanwhile, if the operator has pressed 
the REQUEST key and has entered a reguest 
(REQ) command during execution of the job 
step or any of the above processing, the 
communication task routines set a command- 
pending indicator on during the ensuing 
interruption. The indicator is now checked 
and, if found to be on, control is passed 
to the communication task, which causes a 
message to be issued instructing the 
operator to enter commands, and then pro- 
cesses the commands. 

Step Initiation 

Control next passes to the 
initiator/terminator, which examines I/O 
device reguirements , assigns (allocates) 
I/O devices to the job step, issues mount- 
ing instructions, and verifies that volumes 
have been mounted on the correct units. 
Finally, the initiator/terminator passes 
control to the job step. 

Job and Step Termination 

When processing program execution is 
completed, the supervisor, finding no pro- 
gram request blocks in its request block 
queue, passes control to the job management 
routines. Entry is first made to the step 
termination routine. 



the pre-termination routine issues a 
•PARTITION n WAITING TO TERMINATE' message 
and waits until the partition gains control 
of the scheduler. The step termination 
routine performs end-of-step housekeeping 
and passes control to the user's accounting 
routine, if one was provided. When the 
accounting routine has been executed, the 
supervisor returns control to the step 
termination routine. If the job termina- 
tion indicator is on, control is then 
passed to the job termination routine; or 
to the reader/interpreter if the indicator 
is off and no more steps are ready for 
initiation; or to the step initiation rou- 
tine. 

The job termination routine performs 
end-of-job housekeeping. It exits to the 
user's accounting routine, if one was pro- 
vided. After the accounting routine is 
executed, the supervisor returns control to 
the job termination routine which decre- 
ments the partition shift count by one if 
neither the partition number nor shift 
count is already zero. Control is then 
passed to the reader/interpreter. 



OPERATOR- SYSTEM COMMUNICATION PROCESSING 

The routines that handle operator- system 
communication are contained in the communi- 
cation task. Communication may take one of 
two forms: commands, which allow the opera- 
tor to change the status of the system or 
of a job or job step; and the WTO or WTOR 
macro-instructions, which allow processing 
programs or system components to issue 
messages to the operator. The communi- 
cation task routines also switch functions 
from the primary console device to an 
alternate console device when the INTERRUPT 
key is pressed. 



Command Processing 

Commands may be issued by the operator 
in two ways: he may insert command state- 
ments between job steps in the input job 
stream, or he may issue commands through 
the console input device. Commands encoun- 
tered in the input job stream cause control 
to be passed to the communication task, 
which processes them. Before entering com- 
mands through the console, however, the 
operator must press the REQUEST key to 
cause an attention interruption. Figure 5 
shows the actions taken after the key is 
pressed. 

WTO/WTOR Macro- Instruction Processing 



Step termination may occur only when the 
scheduler is attached to the terminating 
partition. If termination cannot occur, 



Whenever the WTO or WTOR macro- 
instruction is issued, a supervisor 
interruption occurs. (See Figure 6.) 
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External Interruption Processing 

When the operator presses the INTERRUPT 
key, an external interruption occurs. The 
communication task then switches functions 
from the primary to the alternate console 
I/O device. (See Figure 7.) 



ENQ/DEQ PROCESSING 

The enqueue and dequeue service rou- 
tines, through which the ENQ and DEQ macro- 
instructions are implemented, provide for 
controlled, sequential access to serially 
reusable resources such as data sets, 
programs, or work areas in main storage. 
The routines service both problem program 
ENQ/DEQ requests, and requests from the 
system's job management and fixed- task 
supervision routines. The primary function 
of the enqueue and dequeue service routines 
is to test for the availability to the 
requesting task of a serially reusable 
resource, to enqueue the request if neces- 
sary, and to dequeue the request when use 
of the resource is complete. 

In addition, the service routines permit 
system routines to set a system- must- 
complete flag before performing a critical 
operation, then to remove (reset) the flag 
when the operation has been successfully 
completed. This feature is available only 
to system routines; use of the system-must- 
complete feature in a problem program 
causes abnormal termination. 





Supervisor 


Program Issues 


Identifies 
Type of 
Interruption 


WTO/WTOR Macro-Instruction 

Communication Task 






Writes Message 
(Generates 
Reply Queue Entry 
if WTOR) 








Returns 
Control to 
Point of 
Interruption 







A. Message Processing 



Supervisor 



Operator Presses 




Identifies 
Type of 
Interruption 


REQUEST Key 

Communication Task 






Reads 
Reply 










Returns 
Control to 
Point of 
Interruption 




Processes 
Reply 













ENQ/DEQ Control Blocks 

Resources are identified by the request- 
er through a major name, specifying a set 
of resources, and a minor name, specifying 
a particular resource within that set. An 
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Figure 5. Attention Interruption Process- 
ing Flow 



B. Reply Processing 

Figure 6. WTO/WTOR Macro- Instruction 
Processing Flow 



enqueued request has associated with it 
three control blocks: a major queue control 
block (QCB) , a minor QCB, and a queue 
element. (See the program listing for the 
structure and contents of these control 
blocks.) 

The major QCB represents the set of 
resources specified by the major name pa- 
rameter of the ENQ request. All major QCBs 
existing in the system at a given time are 
linked together; the head of the major QCB 
chain is a control field (IEAQQCBO) within 
the enqueue service routine. 

Queued on each major QCB are the minor 
QCBs corresponding to the minor names of 
the specific resources for which requests 
have been issued. Queued on each minor QCB 
are queue elements representing the tasks 
under which the outstanding requests were 
issued. 
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Note^ If the STEP operand is included in 
an ENQ or DEQ macro- instruction, the pro- 
tection key for the job step is treated as 
part of the minor name when the minor QCB 
queue is searched. If two requests specify 
the same major and minor name and if either 
request or both includes the STEP operand, 
both requests will be represented by the 
same major QCB but different minor QCBs. 
However, because the Option 2 system does 
not include the ATTACH and DETACH macro- 
instructions, the STEP operand has no 
effect. 



If the SYSTEM operand is included in an 
ENQ or DEQ macro- instruct ion, the minor 
name is used as specified. Two requests 
specifying the same major and minor name 
and SYSTEM will be represented by the same 
major QCB and the same minor QCB. 



All ENQ/DEQ control blocks are dynami- 
cally created and deleted, as ENQ and DEQ 
requests are processed and as other system 
functions, such as abnormal termination, 
are performed. The physical location of 
the major and minor QCBs, with respect to 
the partition in which the requesting task 
was operating, varies depending upon the 
circumstances of their creation and dele- 
tion. When an ENQ request is serviced, a 
GETMAIN is issued to obtain main storage 
for a major QCB, a minor QCB, and a queue 
element. The queue element is always 
developed and linked to the appropriate 
control block; queue elements remain in the 
requesting partition from their creation 
(on ENQ) until their deletion (normally on 
DEQ) . The main storage obtained for the 
QCBs may or may not be used at the time 
that the queue element is created. Major 
and minor QCBs are copied from partition to 
partition as required by the sequence in 
which queue elements are dequeued. If the 
required major and/ or minor QCB already 
exist in another partition, the correspond- 
ing area(s) in the requesting partition is 



reserved for use if it becomes necessary to 
copy the QCB(s) into the requesting parti- 
tion. 



For a summary of typical control block 
patterns during ENQ/DEQ, see Figure 8. 



Sequence of Execution for Enqueued Tasks 

The queue elements enqueued upon any one 
minor QCB represent tasks that have 
requested access to the corresponding 
resource. When control within a task pass- 
es to the enqueue service routine, the task 
may enter an effective wait until the 
request is serviced; that is, control is 
not returned from the enqueue service rou- 
tine to the processing program until the 
resource has actually been made available 
to the task. The time at which a task 
proceeds (through re-entry to the calling 
routine) is determined by the relative 
position of shared and exclusive requests 
on the queue, and by the status of each, as 
described in the following paragraphs. 



A queue element may be thought of as 
being ready or not-ready, where the condi- 
tion ascribed to the queue element is 
actually the condition of the associated 
task. Then an ENQ specifying several 
resources is issued, the wait count in the 
SVC request block (SVRB) associated with 
the request is set to the number of resour- 
ces requested by, but unavailable to, the 
task. Whenever the wait count in an SVRB 
is non-zero, the routine to which the SVRB 
points cannot proceed, although the the 
task with which the SVRB is associated may 
not be waiting. This condition is summar- 
ized by describing the queue element as 
not-ready. Conversely, a queue element may 
be described as "ready" when the wait count 
in the associated SVRB is zero. 



If any queue element preceding the first 
exclusive request on the queue for a 
resource is shared and ready, the task 
associated with that queue element pro- 
ceeds. Furthermore, the tasks represented 
by any subsequent shared and ready requests 
on the queue that precede the first exclu- 
sive request proceed concurrently. The 
first exclusive request, whether ready or 
not-ready, and all subsequent requests, 
whether exclusive or shared, are not ser- 
viced at this time. 

If the queue element at the head of the 
queue is exclusive and ready, the task 
associated with that queue element pro- 
ceeds. No other task represented on that 
queue proceeds until the exclusive request 
has been dequeued. 
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An ENQ is issued in partition B. A QCB 
exists for the specified major name, but not 
for the minor name. Major QCB space is 
reserved in partition B. The minor QCB is 
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for the existing major QCB. The new queue 
element is created. 
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Two ENQs are issued in partition C. The 
first request names a new set of resources; a 
full set of control blocks is created and the 
major QCB is linked to the existing major 
QCB. 

The second request is for the same resource 
ENQd upon in partition B. Since both a 
major and a minor QCB exist, the correspon- 
ding space in partition C is reserved; a queue 
element is created and added to the minor 
QCB's queue element chain. 


MAJOR 
QCB 






MAJOR 
QCB 














MINOR 
QCB 










MINOR 
QCB 








QEL 


MINOR 
QC£ 


QEL 






















QEL 










< 


















QEL 










[" MAJOR 

_Q CB_ __ 

1 MINOR 

QCB_ __ 

1 QEL 






O 










« 

A DEQ is issued in partition A. Because 
there is a second minor QCB (in partition B) 
chained to the major QCB, the major QCB 
is copied into the reserved space in partition 
B. Since there are no further QELs enqueued 
on the minor QCB in partition A, it need not 
be copied. The QEL is no longer required. 
(QELs are never copied.) After the major 
QCB has been copied, the main storage used 
for all three control blocks is freed. 
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A DEQ is issued in partition B. There are 
no further minor QCBs in the major QCBs 
chain, but there is another QEL linked to 
the minor QCB. Therefore, both the major 
and the minor QCBs are copied into the 
reserved space associated with the remain- 
ing QEL. The control blocks in the DEQing 
partition are then deleted via FREEMAIN. 
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Figure 8. ENQ/DEQ Control Block Creation and Deletion 
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If the queue element at the head of the 
queue is exclusive and not- ready, no tasks 
represented on the queue can proceed. 



LOAD MODULES 

Most job management routines exist as a 
series of load modules that reside on a 
permanently resident volume. The only 
exceptions are the posting routines of the 
communication task f which reside in the 
nucleus. The "Load Modules and Assembly 
Modules" section contains a list of the 
routines that make up each job management 
load module. 
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PROGRAM ORGANIZATION 



JOB SCHEDULER MODIFICATIONS 

PARTITION- RELATED SCHEDULER CONTROL BLOCK 

The partition- related scheduler control 
block (PRSCB) is the only new control block 
introduced into the system by Option 2 of 
the control program. One PRSCB is created 
for each partition at nucleus initializa- 
tion. The PRSCBs reside in the nucleus, as 
module IEFSD032, and are defined by a 
DSECT, module IEFSD033. PRSCBs are con- 
tiguous and are arranged by priority order, 
beginning with highest priority (Partition 
0). A pointer to the PRSCB for a given 
partition is contained in the three bytes 
immediately preceding the boundary box for 
that partition. The content and structure 
of the PRSCB are described below. 



SD33ECB 



SD33CTTR 



I- 



SD33STTR 



Field 
SD33ECB 



T T 

I I 

SD33QSTT | SD33LNGHJ SD33IND 

I I 

JL JL 



Bytes Contents 

4 Scheduler-controlling event 
control block. This ECB is 
posted complete whenever the 
scheduler is assigned to the 
partition through a WAITR 
issued in the next-higher- 
priority partition . The 
wait flag in this ECB is 
turned on when the scheduler 
is relinquished, either 
through a WAITR in this par- 
tition or through processing 
of a SHIFT command. 



SD33CTTR 4 Current TTR save area. When 
a partition relinquishes 
scheduler control through a 
WAITR, the scheduler down- 
shift routine stores in this 
field (in TTR form) the next 
location in the queue- 
manager's extent that would 
have been used by the 



Field Bytes Contents 

queue-manager if further 
records were to have been 
written for the relinquish- 
ing partition. The system 
job queue variable area 
applicable to the next- 
lower- priority partition 
begins on the next full 
track following this loca- 
tion. 

SD33STTR 4 Fixed- area table save area. 
When a partition relinquish- 
es scheduler control through 
a WAITR , the relinquishing 
partition's JCT, SCT, and 
LCT are moved from the fixed 
area to this save area, fol- 
lowing the variable informa- 
tion for the relinquishing 
partition. 

SD33QSTT 2 Starting track location save 
area. This area contains 
(in TT form) the location of 
the track on which the vari- 
able area for the partition 
begins . 

SD33LNGH 1 Offset to PRSCB for active 
partition. This byte is 
meaningful only in the PRSCB 
for Partition 0. Whenever a 
scheduler upshift or down- 
shift is effected, the 
length of one PRSCB (16 
bytes) is added to or sub^ 
tracted from this field in 
the Partition PRSCB. This 
value, added to the address 
of the PRSCB Partition 0, 
yields the address of the 
PRSCB for the partition to 
which the scheduler is cur- 
rently assigned. 



SD33IND 



Partition identification; 
contains 00 for Partition 0, 
01 for Partition 1, etc. 



TERMINATION 

The termination function of the 
initiator /terminator (Chart 12) performs 
post-step and post- job housekeeping. It is 
normally given control following step exe- 
cution, but is also given control when a 
job management routine encounters an 
irrecoverable error while processing a job 
step. Termination routines: 
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• Release space occupied by tables. 

• Free I/O devices. 

• Dispose of data sets referred to or 
created during execution. 

Major components of termination are: 

• The pre- termination routine, which de- 
termines if the scheduler is currently 
associated with the terminating parti- 
tion. 

• The step termination routine, which 
performs post- step housekeeping func- 
tions . 

• The job termination routine, which per- 
forms post- job housekeeping functions. 

• The shift count interrogator, which 
determines whether a shift is to be 
performed. 

The disposition and unallocation subrou- 
tine is used by both the step and job 
termination routines. Basically, this sub- 
routine handles disposition of data sets 
and frees devices allocated to a step. The 
disposition and unallocation subroutine is 
described in the publication IBM System/360 
Operating System: Job Management, Program 
Logic Manual . 



PRE- TERMINATION ROUTINE: The pre- 
termination routine (Chart 13) is new for 
the Option 2 system. The routine is 
entered from the supervisor when the prob- 
lem program has issued its highest-level 
return, causing the supervisor's ABEND rou- 
tine to be entered; the second load module 
of the ABEND routine exits to the job 
management GO module. 

Working through the communication vector 
table, the pre- termination routine obtains 
the address of the TCB for the current task 
(the task that is attempting to terminate) , 
obtains from the TCB a pointer to the 
related boundary box, and obtains from the 
boundary box the address of the partition- 
related scheduler control block (PRSCB) for 
the partition in which the terminating task 
was operating (see Figure 9). The first 
fullword of the PRSCB is the scheduler- 
controlling ECB for that partition. 

The ECB is posted complete if the 
terminating partition has never issued a 
first WAITR macro- instruction, and has 
therefore never relinguished control of the 
scheduler, or if the partition has relin- 
quished control but has again been assigned 
scheduler control through SHIFT command 
processing. If the wait flag is on in the 
ECB, the partition has relinquished schedu- 



ler control through a WAITR and the schedu- 
ler is currently oriented toward some par- 
tition of lower priority; termination can 
proceed only after the scheduler has been 
re-associated with the terminating parti- 
tion. 

If the wait flag is on in the 
scheduler-controlling ECB for the 
terminating partition , the pre-termination 
routine issues a 'PARTITION n WAITING TO 
TERMINATE 1 message and waits on the ECB. 
(The ECB is posted complete when a SHIFT 
command causes the scheduler upshift rou- 
tine to pass control of the scheduler from 
the next-iower-priority partition to this 
partition.) If the complete flag is on, 
the routine bypasses the message, issues a 
WAIT on the ECB to decrement the wait 
count, and continues processing. 

When the wait for scheduler control is 
satisfied, the pre-termination routine 
examines the completion code in the ECB. A 
completion code of 4 indicates that schedu- 
ler control was relinquished by, and 
returned to, the terminating partition. 
Control was originally relinquished through 
a WAITR macro-instruction; when the WAITR 
was processed, the first-time WAITR switch 
for this partition was turned off. If this 
is the case, the pre-termination routine 
turns the switch back on, in preparation 
for the first WAITR macro-instruction in 
the next job (if any) to be scheduled into 
the terminating partition, and resets the 
completion code in the ECB to zeros. 

If the completion code is not h, the 
terminating partition has never relin- 
quished control and its first-time WAITR 
switch is, therefore, still on. In this 
case, resetting the switch is bypassed. 

When these actions are complete, the 
pre-termination routine enters the step 
termination routine through a branch. 



STEP TERMINATION ROUTINE: The step termi- 
nation routine performs its functions when 
a step has been terminated either normally 
due to successful completion of execution 
or abnormally due to an error condition. 
It uses five major routines: 

• Step termination control routine. 

• Step termination data set driver rou- 
tine. 

• Job statement condition code routine. 

• Disposition and unallocation subrou- 
tine. 

• User f s accounting routine (if included 
in the configuration) • 
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Upon successful execution of a step or 
abnormal termination of execution, control 
is passed from the supervisor to the step 
termination control routine. In addition, 
when a job management routine encounters an 
irrecoverable error, it immediately passes 
control to the step termination control 
routine. 

First, the initiator/terminator task 
input/output table (TIOT) and the linkage 
control table (LCT) are read into main 
storage. Next, the cancel ECB is set to 
zero in the selected job queue. The job 
control table (JCT) and the step control 
table (SCT) are then read into main storage 
(if they are not in main storage at the 
time) , and a step status code is inserted 
into the SCT. 

The step data set driver routine is then 
entered. It reads the step input/output 
table (SIOT) for each data set into main 
storage and branches to the disposition and 
unallocation subroutine. The loop through 
the data set driver routine and the dispo- 
sition and unallocation subroutine is then 
repeated for each SIOT. 

When all data sets have been processed 
by the disposition and unallocation subrou- 
tine, the updated SCT is returned to auxil- 
iary storage. Control is then passed to 
the job statement condition code routine, 
unless it is known that there are no 
further steps for the job (the reader/ 
interpreter had encountered a JOB or null 
statement) . In the latter case the job 
statement condition code routine is 
bypassed. 

The job statement condition code routine 
processes condition codes specified in the 
JOB statement. 

If, upon entry into the job statement 
condition code routine, it is found that 
there were no condition codes specified in 
the JOB statement, control is returned to 
the step termination routine. Each condi- 
tion code in the JCT for the job is in turn 
compared with the step completion code of 
the previous step, which appears in its 
SCT. Up to eight conditions are checked by 
this routine for each step. Any additional 
condition codes are ignored. If any of the 
condition operators are satisfied by the 
codes, the job- failed indicator in the JCT 
is updated to indicate that the job failed, 
the message subroutine is used to issue a 
message to the programmer, and control is 
returned to the step termination routine. 

Upon return from the job statement con- 
dition code routine, or if it had been 
bypassed, the step termination routine 
exits to the user's accounting routine, if 
one is present. On return from the 



accounting routine, or if there was none, 
the step termination routine passes control 
to: 

• The job termination routine, if the 
current step is known to be the last 
step of the job. 

• The initiator/terminator system control 
routine, if additional steps have been 
interpreted and are ready to be ini- 
tiated. 

• The reader/interpreter control routine, 
which resumes processing the input job 
stream. 



JOB TERMINATION ROUTINE: The job termina- 
tion routine (Chart 15) performs its func- 
tions when an entire job has been executed 
and step termination for its last step has 
been completed. It consists of four major 
routines : 

• Job termination control routine. 

• Release job queue routine. 

• Disposition and unallocation subrou- 
tine. 

• User's accounting routine (if included 
in the configuration) . 

Control is passed to the job termination 
control routine from the step termination 
routine. 

The job termination control routine de- 
termines if a passed data set queue exists 
and, if so, reads each block into main 
storage and tests for unreceived data sets. 
(An unreceived data set is a passed data 
set to which no reference is made after 
PASS is specified. ) When an unreceived 
data set is found, entry is made to the 
disposition and unallocation subroutine. 
When all unreceived data sets have been 
processed, or if no passed data set queue 
exists, the job termination control routine 
passes control to the accounting routine, 
if there is one. 

When the accounting routine returns, or 
if there is no accounting routine, the 
completed job's control tables are removed 
from the system by the release job queue 
routine. This routine releases the auxil- 
iary storage space occupied by all control 
tables for the job. If the job notifica- 
tion switch is on, the message 

IEF402I jobname ENDED 

is written on the console device. Control 
is then passed to the shift count interro- 
gation routine. 
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SHIFT COUNT INTERROGATION ROUTINE: For the 
Option 2 system , the shift count interroga- 
tor (Chart 16) is added as the final step 
of the job termination routine. If the 
scheduler is not already in partition and 
the shift count is not zero, the count is 
decremented by one and control is passed to 
the scheduler upshift routine. Otherwise 
the shift count is zeroed out and control 
is passed to the reader/interpreter control 
routine. 



SCHEDULER CONTROLLER 

Acting in conjunction with the 
reader/ interpreter and the initiator/ter- 
minator , the scheduler controller is the 
third element of the job scheduler. The 
function of the controller is to adjust the 
system job queue and monitor the operation 
of the reader/interpreter and initiator/ 
terminator as required for multi-partition 
processing. 

The system job queue is a data set 
containing control information produced by 
the reader/interpreter and used throughout 
job scheduling. The direct access area on 
which the data set resides is known as the 
queue-manager extent (see Figure 10). This 
extent is defined at system generation time 
and is initialized at nucleus initializa- 
tion. 

During initial reader/interpreter opera- 
tions — that is, up until the time when 
the first job in the input stream begins 
execution and issues a WAITR — the con- 
tents of the queue- manager extent is organ- 
ized as for the sequential scheduled sys- 
tem. The extent includes a fixed area 
(sometimes referred to as the "pre-empted 
track area") immediately followed by a 
variable area. Within the fixed area are, 
among other control fields, three key con- 
trol tables: a link control table (LCT) , a 
job control table ( JCT) , and a step control 
table (SCT) . The variable area contains 
additional control fields and tables. 
(Each record in the variable area is fixed 
at 176 bytes; however, the number of 
records in the area can vary.) 

Major scheduler control components are: 

• The downshift routine, which reinitial- 
izes the scheduler for operation in the 
next- lower- priority partition. 

• The upshift routine, which is entered 
when the scheduler is to be shifted to 
the next-higher- priority partition. 

SCHEDULER DOWNSHIFT ROUTINE: The scheduler 
downshift routine (Chart 18) is entered as 
a result of WAITR issuance in the next- 
higher- priority partition. This routine 



reinitializes the scheduler for operation 
in the next-lower-priority partition, 
issues the message 

PARTITION n STARTED 

and exits to the reader/interpreter. The 
following paragraphs describe how prepara- 
tion for scheduling in the second partition 
is performed. (Throughout the following 
discussion, 'Partition A' refers to the 
partition in which the WAITR was issued and 
which is relinquishing the scheduler. 
'Partition B' refers to the next- lower- 
priority partition — the partition to 
which the scheduler is being assigned.) 

When the scheduler downshift routine is 
entered, the PRSCB for Partition B is 
cleared to zeroes, except for the complete 
flag in the scheduler-controlling ECB, 
which was just set on by the WAITR routine, 
and the partition identification byte which 
remains constant. The routine then gets 
main storage and reads in the LCT, JCT, and 
SCT from the queue-manager's extent on 
direct access. New job, link, and step 
control tables are constructed and read 
back into the fixed area; the tables that 
were read in from the fixed area are then 
written into the variable area associated 
with Partition A. 

The variable area associated with 
Partition A now contains the scheduler 
information in the same state as when the 
scheduler was operating in that partition. 
The control information in the standard 
portion of the variable area is applicable 
only to Partition A and will not be affect- 
ed by operation of the scheduler in another 
partition. The control information in 
those portions of the fixed area that are 
always referred to by the scheduler (the 
LCT, SCT, and JCT), regardless of what 
partition it is operating in, has been 
saved and the fixed area re-initialized for 
further use. 

When this operation is complete, the 
pointers in the PRSCB for Partition A 
indicate (in TTR form) the location of: 

SD33QSTT The beginning of Partition A's 
variable area. 

SD33STTR The beginning of the LCT/SCT/JCT 
save area within that variable 



SD33CTTR The next available TTR on the 
queue-manager's extent; i.e., the 
location beyond which the vari- 
able area for Partition B, if one 
is required, is to be built. 

Control is then passed to the reader- 
interpreter. 
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QUEUE-MANAGER'S EXTENT 



Fixed Area 
(Pre-Empted Track Area) 



Variable Area 
(Up to four partitioned-related areas) 



/ 



/ 



/\ 



/ 



/ 



/ 



/ 



NWRT 


JFCB1 


JFCB2 


JFCB3 


JFCB4 


JFCB5 


JFCB6 


LCT 

* 


IWA 


JFCB7 


TIOT 


JCT 


SCT 



The fixed area (described by 
DSECTIEFSD005) is used for , 
scheduling in any partition. / 



/ 



/ 



/ 



-* These tables are used for scheduling the active 
partition, and are saved in the variable area 
associated with the active partition when sched- 
uler control is relinquished. 



/ 



f 



/ 



PARTITION 
(First Variable Area) 

A 



~V~ 



PARTITION 1 
(Second Variable Area) 

A 



~\ 



JCT SICTs 

SMBs JFCBs 

SCTs VOLUME Tables 

ACTs DSNAME Tables 



Problem 

Program 

TIOT 





TTR saved in-" 
SD33STTR 



Control data used for sched- 
uling when partition has 
scheduler control 



L TTR saved in 
SD33CTTR 



Area where fixed area 
tables are stored when 
control is relinquished 



Figure 10. Queue-manager's Extent Layout 



SCHEDULER UPSHIFT ROUTINE: The scheduler 
upshift routine (Chart 17) is entered from 
the shift count interrogator when job 
termination has been completed in a parti- 
tion (Partition B f for purposes of 
discussion) and the scheduler is to be 
shifted to the next-higher- priority parti- 
tion (Partition A) in response to a non- 
zero shift count. 

When the scheduler upshift routine is 
entered, the last of the scheduler's 
termination routines has already issued a 
GETMAIN for main storage to be used by the 



reader/interpreter. This main storage is 
freed, and a GETMAIN is issued to obtain 
the main storage required by the pointer 
restore routine. Into this main storage is 
read the LCT, SCT, and JCT associated with 
Partition A. 

After reading the required control 
tables into main storage, the routine 
writes thera into the queue- manager's fixed 
area and resets the queue-manager's 'active 
area' pointer (SCATALLY) to the beginning 
of Partition A's variable area. The con- 
trol information available to the queue 
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manager is now in exactly the same status 
as it was when scheduler control was ini- 
tially relinquished. 

With the scheduler switch complete, the 
routine posts the scheduler- control ling ECB 
for Partition A and issues a wait on the 
ECB for Partition B. This wait is satis- 
fied if a subsequent job scheduled into 
Partition A issues a WAITR; if the wait is 
satisf ied, the scheduler downshift routine 
is brought into Partition B and executed. 



COMMUNICATION TASK 

The communication task (Chart 02) pro- 
cesses all operator commands and messages 
directed to the operator through use of the 
WTO and WTOR macro- instructions. It also 
performs console switching when the secon- 
dary console is to be used in place of the 
primary console. 

The eight major routines of the communi- 
cation task are: 

Console interrupt routine , which noti- 
fies the communication task wait routine 
that a console read has been requested. 

Communication task wait routine , which 
waits for all WTO/WTOR requests and 
console interrupts and calls the com- 
munication task router routine. 



Figure 11) . Before entering commands 
through the console I/O device, the opera- 
tor must cause an I/O interruption. When 
he does, control is given to the supervisor 
which recognizes the interruption and pass- 
es control to the I/O supervisor. The I/O 
supervisor determines that the interruption 
is an attention signal and passes control 
to the master scheduler console interrupt 
routine. 



The console interrupt routine resides in 
the nucleus. It posts the attention ECB in 
the unit control module (UCM) and sets the 
attention flag in the UCM list entry cor- 
responding to the device from which the 
interrupt came. Posting of the attention 
ECB causes the communication task wait 
routine to be dispatched. 



The communication task wait routine 
waits on all communication ECBs associated 
with WTO/WTOR. The wait module issues a 
multiple wait macro- instruct ion on a list 
of event control blocks contained in the 
UCM. When one of the event control blocks 
is posted, as by attention or external 
interrupts, the wait is satisfied and the 
communication task thus becomes ready. 
When it becomes the active task, it issues 
the SVC 72. This SVC includes the console 
communication service routines and the 
router. 



Communication task router routine , which 
determines the type of request or inter- 
rupt that occurred and passes control to 
the appropriate processing routine. 

Console device processor routine , which 
performs console read and write opera- 
tions and error checking. 

Master command processor routine , which 
processes all commands read from the 
console input device except SET, START 
RDR, and START WTR. 

Master command routine , which analyzes 
command verbs and routes control to 
appropriate command execution routines. 

Write-to- operator routine , which manages 
WTO buffers and requests console writes 
via the communication task wait routine. 



External interrupt routine . 



which 



switches to the alternate console device 
when an external interruption occurs. 



Because the communication task serves a 
number of purposes, the first segment of 
SVC 72 is a routine that distinguishes 
among these purposes and establishes the 
order of response. This routine is called 
the router,. The primary order of response 
is: external interruption, I/O completion, 
attention, and WTO(R). 



When a posted ECB is found by the 
router, the router XCTLs to the specified 
processor module. 

The console device processor routines 
perform reading and writing by using the 
EXCP macro-instruction. The processor rou- 
tines consist of a routine to service 
external interruption and three device- 
oriented routines: 1052 operator console 
routine, card reader routine, and printer 
routine. With each of the three console 
I/O processor routines is associated an 
OPEN/CLOSE support routine, which provides 
Data Management and I/O Supervisor control 
blocks. 



COMMUNICATION TASK CONTROL FLOW 

Commands are issued through either the 
console I/O device or the input reader (see 



The specified processor routine reads 
the input message into a buffer area and 
calls the master command processor routine 
via an SVC. 
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The master command processor routine 
analyzes the command for validity. Ten 
commands (REQ, START (blank) , CANCEL, 
DISPLAY, MOUNT, STOP, UNLOAD, VARY, SHIFT 
and REPLY) are always accepted and process- 
ed. All other commands are ignored 
(control is returned to the supervisor) if 
issued at any time other than in response 
to a message issued by the master command 
routine. If the command is acceptable, it 
is moved from the buffer into which it was 
read to a local buffer, and control is 
passed to the master command routine. 



The master command routine analyzes com- 
mands and routes control to appropriate 
command execution routines. If a command 
is issued through the input job stream, 
control is passed directly to the master 
command routine by the reader/interpreter. 
When all commands have been entered and 
processed, control returns to the 
reader/interpreter. 

The write-to-operator routine moves the 
text from the requesting program's area 
into a buffer area within the nucleus and 
posts the communication ECB for write-to- 
operator. If the request was a WTOR, a 
message ID is generated and a reply queue 
entry is created to allow handling of the 
reply by the operator. 

The external interrupt routine assigns 
the functions performed by the primary 
console device to the alternate console 
device. When the operator presses the 
INTERRUPT key on the console, an external 
interruption occurs and control is given to 
the supervisor, which identifies the 
interruption and passes control to the 
external interrupt routine. The external 
interrupt routine then switches consoles 
and returns control to the supervisor. 
Console functions may later be reassigned 
to the primary console device if the opera- 
tor causes another external interrupt. 



CONSOLE INTERRUPT ROUTINE 

The console attention interrupt routine 
(Chart 04) POSTs the communication task 
attention ECB to request reading of the 
console. The routine is logically part of 
IOS. It operates in privileged mode, I/O 
interrupt disabled, without destroying the 
registers, and without macro access to 
supervisor services. Using the pointer to 
the UCB found in register 7, the UCB 
address is matched to a UCM entry. The 
attention flag for the entry is turned on. 
A branch entry to POST pointing at the 
attention ECB in the UCM, is then taken. 
Register 14 is used to return to IOS. 



COMMUNICATION TASK WAIT ROUTINE 

The communication task wait routine 
(Chart 07) issues a WAIT to the list of ECB 
addresses contained in the Event Indication 
List (EIL) . The communication task is thus 
able to respond to a variety of events 
since the POSTing of any one ECB satisfies 
the wait. The POST issued in the console 
attention interrupt routine satisfies the 
wait, and results in the placement of the 
TCB on the ready queue. When next dis- 
patched, the wait routine issues an SVC 72 
which results in: (1) the creation of an 
SVRB; and (2) the fetching of the first 
segment of the console processor routines 
into the system transient area. 



COMMUNICATION TASK ROUTER 

The router (Chart 08) , IEECVCTR, is the 
first segment of SVC 72 brought into the 
transient area. Since the communication 
task serves a number of purposes, and since 
service requests may be simultaneously 
pending, the router establishes the order 
of response. The primary order of treat- 
ment is external interrupt, I/O completion, 
attention (console interrupt), and WTO(R). 
Multiple attentions are treated in order of 
appearance in the UCM. Multiple I/O com- 
pletions are treated in order of first use 
of the device. The router responds to an 
attention by building a parameter list in 
the SVRB extended save area. It consists 
of a remote XCTL parameter list, a pointer 
to the appropriate UCM entry, and a pointer 
to the UCM (contents of CVTCUCB) . The 
router then passes control to a processor 
routine by issuing an XCTL to the remote 
parameter list, using the name obtained 
from the UCB entry. The flag signifying 
the request to be serviced by the processor 
routine will be turned off by the processor 
routine. Consequently, processor routines 
return control to the router with XCTL to 
allow it to schedule service for other 
requests. 



If no requests are pending, the router 
exits to the wait routine using the address 
in register 14. 



In addition to distinguishing the output 
request from other requests, the router 
selects the particular device to which the 
message is to be sent. The router estab- 
lishes the output device by interrogating 
UCB entry attribute indicators. The 
appropriate entry is the first active entry 
that supports WTO. As before, the router 
builds a remote interface for, and passes 
control via XCTL to, a processor routine. 



30 



CONSOLE DEVICE PROCESSOR ROUTINES 



MASTER COMMAND PROCESSOR ROUTINE 



Control flow in a processor routine 
(Chart 10) is determined almost exclusively 
by the setting of flags in the router- 
selected UCM entry. The close flag is 
tested first. If this flag is on, any 
pending I/O activity is suspended by 
issuing a WAIT* An XCTL is then issued to 
an associated OPEN/CLOSE support routine 
for release of various control blocks. If 
the close flag is off, the busy flag is 
tested to determine I/O status. If there 
is outstanding I/O activity, error checking 
and buffer disposition occur if the activi- 
ty has been POSTed complete. Otherwise, 
any attention request is temporarily aban- 
doned (so are output requests), and an XCTL 
return to the router is taken. If the busy 
flag is off, the attention flag is tested, 
and if on, the status of the device is 
examined. If the device has not been 
opened, an XCTL to an associated OPEN/CLOSE 
support routine is issued for the purpose 
of obtaining core for a DCB and access- 
method dependent control blocks, and for 
execution of the OPEN macro. 



When return is made from the OPEN/CLOSE 
support routine, a response to the 
attention flag is prepared. A fixed buffer 
in the UCB is reserved and an access-method 
dependent interface is constructed. I/O 
activity is initiated by issuing EXCP for a 
1052, and by issuing a READ for a unit 
record device. In no case does the process 
routine await completion of this activity. 
Control is immediately returned to the 
router by issuing XCTL. 



Control flow within the processor rou- 
tine is as previously described up to the 
point at which the output request flag is 
tested. If on, the processor routine 
obtains the address of an output buffer 
from the UCM. The element is not removed 
from the queue at this time; this occurs 
only on successful completion of I/O. The 
reason is to preserve a natural method of 
having the message retried if an external 
interrupt intervenes before the message is 
successfully presented to the current 
device. Since output buffers are always 
selected from the top of the queue, the 
initiation of output to an alternate device 
would be unaffected by any previous 
attempts to present the message to the 
primary device. 

Having selected a buffer, the processor 
routine establishes data management and IOS 
control block linkages; and issues EXCP for 
a 1052, or WRITE for a printer. Without 
awaiting completion of the I/O, the proc- 
essor routine returns via XCTL to the 
router . 



The master command processor routine 
(Chart 05) processes the CANCEL, DISPLAY, 
MOUNT, REPLY, REQ, SHIFT, START (blank), 
STOP, UNLOAD, and VARY commands. It 
resides on the system residence device and 
is brought into the transient area of the 
nucleus by the supervisor when an SVC 34 
instruction is issued by the communication 
task or the master command routine. 

If the command is one of the ten pre- 
viously mentioned commands, it is processed 
by the SVC 34 routine. SET, START RDR, and 
START WTR commands are ignored unless they 
were issued in response to a message from 
the master command routine. If so, control 
is passed to the master command routine, 
which processes them. 

If entry to the master command processor 
routine was from the master command rou- 
tine, the command is available in a buffer 
(placed there by the master command 
routine) . The command is processed. 

The master command processor routine 
returns control to the router. 



MASTER COMMAND ROUTINE 

The master command routine analyzes com- 
mand verbs and routes control to appropri- 
ate command execution routines. It also 
issues a message to the operator, informing 
him that commands will be accepted from the 
console. The master command routine is 
brought into main storage and entered when 
any of the following occur: 

• The reader/interpreter encounters a 
command in the input job stream. 

• The reader/interpreter is performing 
the initialization procedures that fol- 
low IPL. 

• The reader/interpreter finds the com- 
mand pending switch on. (The command 
pending switch is turned on by the 
routine that processes the REQ 
command. ) 

• The reader /interpreter encounters an 
end-of-data set condition in the input 
job stream, indicating the end of a job 
step or job. Control is passed to the 
master command routine after the job 
step has been processed. 

Upon entry to the master command rou- 
tine, general register is examined. If 
it contains zeros, entry was made because 
the reader/interpreter encountered a com- 
mand in the input job stream. The command 
is moved to the master command routine 
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buffer and is written out on the console 
output device for the operator's records. 
The command verb is then analyzed: if it is 
a SET, START RDR, or START WTR command, 
control is passed to an appropriate command 
execution routine. Otherwise, an SVC 34 
instruction is used to pass control to the 
master command EXCP routine. 

If general register " does not contain 
zeros upon entry to the master command 
routine, the IPL pending, new reader pend- 
ing, and new writer pending switches are 
checked. If any of these switches are on, 
the command pending switch is turned on and 
a message is issued requesting the operator 
to enter commands. Control is then passed 
to the initialization command routine, 
which provides certain commands, specified 
by the installation during system genera- 
tion (SYSGEN) , to relieve the operator of 
entering initialization commands. Each of 
the commands provided is moved to the 
master command routine buffer, written on 
the console output device for the 
operator's records, and executed. 

If general register does not contain 
zeros and none of the previously-mentioned 
pending switches are on, entry to this 
routine was made because the reader/inter- 
preter found the command pending switch on, 
or encountered an end- of- data set condition 
in the input job stream. A message is 
issued requesting commands from the opera- 
tor. After the operator has issued com- 
mands and they have been processed, control 
is returned to the reader/interpreter. 



message ID is placed in the RPQE with other 
information to insure passing the reply, 
when received, to the proper area. WTO 
messages are invariably written out; a WTOR 
message may be purged (removed from the 
queue) if the issuing task terminates while 
the message is on the buffer queue. There- 
fore, an RPQE differs from a WQE in that it 
contains the address of the issuing task's 
TCB. The buffer queue is accessed through 
the entry UCMWTOQ in the UCM. 

The reply queue contains RPQEs for oper- 
ator replies to WTOR. Elements in this 
queue, like WTOR elements in the buffer 
queue, contain a TCB address to permit 
purging. 

The extent of both queues is limited by 
specifying the number of buffers at system 
generation. An attempt to exceed a thres- 
hold value will result in an ENQ of the 
requesting task. 

For a reply (to WTOR) , the processor 
issues SVC 34 (command processing) . The 
SVC routine determines that the incoming 
command is in fact a reply, processes the 
reply, POSTs the user's ECB and branches 
back to the processor. 



EXTERNAL INTERRUPT ROUTINE 

The external interrupt routine (Chart 
04) switches to an alternate console device 
when the operator presses the INTERRUPT key 
on the console. This routine resides in 
the nucleus. 



WRITE- TO- OPERATOR ROUTINE 

The write- to-operator routine (Chart 06) 
writes operator messages on the console 
output device when a WTO or WTOR macro- 
instruction is issued. These macro- 
instructions may be issued by the system 
component programs and processing programs. 
Messages and replies are buffered; the 
period of time between the message and the 
reply is available for processing. 
Issuance of either macro- instruction causes 
an SVC interruption. When the interruption 
is handled, the supervisor has the routine 
read into the transient area of the nucleus 
and passes control to it. 

There are two console queues: the buffer 
queue and the reply queue. Each WTO and 
WTOR results in the addition of a WTO Queue 
Element (WQE) to the buffer queue, and each 
WTOR results in the addition of a Reply 
Queue Element (RPQE) to the reply queue. 
WTO and WTOR represent requests to present 
a message to the operator. SVC 35 sets up 
the user's messages and, if WTOR, inserts 
the message identification (ID) which the 
operator must use for his reply. The same 



SUPERVISOR MODIFICATIONS 

WAITR — SINGLE EVENT 

For the Option 2 system, the WAIT ser- 
vice routine also processes WAITR macro- 
instructions issued by a processing program 
to cause job management to be initiated in 
the next- lower- priority partition. If, 
when the routine is entered, the wait count 
is negative — i.e., has been complemented 
— a WAITR has been issued. The routine 
determines whether the WAITR is the first 
that has been issued by the processing 
program. If the WAITR is not the first, or 
if the WAITR has been issued in the lowest- 
priority partition (from which no down 
shift is possible) , the WAITR is treated as 
a WAIT with the same parameters. 

When a first WAITR is encountered and 
there is a next- lower- priority partition, 
the routine makes the task associated with 
that partition di spat enable. When that 
task is dispatched, job management routines 
are entered to cause a job to be scheduled 
into the partition. 
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When a first WAITR is serviced , a switch 
is set so that any subsequent WAITR issued 
in the same partition is treated as a WAIT. 
This switch is reset only upon termination 
of the job. 



NUCLEUS INITIALIZATION PROGRAM 

The primary change in the operation of 
NIP under control program Option 2 is that 
the standard partition initialization 
functions are repeated for each partition 
in the system. For each partition, just as 
for the single partition that exists with- 
out Option 2, a boundary box, a free area 
queue element, a PRB, and the required XCTL 
code are established. For a fall explana- 
tion of the nucleus initialization program, 
including partition initialization, refer 
to IBM System/360 Operating System; Fixed- 
Task Supervisory Program Logic Manual . 



ENQ/DEQ SUPPORT 

Enqueue Service Routine — IEAQENQQ 

This routine (see Charts 19 through 22) 
is entered through a branch from a system 
routine, or from the SVC second-level 
interrupt handler in response to an ENQ 
(SVC 56). When the routine is entered, the 
major and minor QCBs are searched for 
existing control blocks representing the 
requested resource. If the required major 
and/or minor QCB are not found, the routine 
takes the action appropriate to the 
RET= parameter, as follows: 

• RET=TEST — the routine sets a return 
code of 00 (resource is available). 

• RET=USE or HAVE — the routine sets a 
return code of 00. The routine issues 
a GETMAIN and creates a queue element. 
A minor QCB or a minor and a major QCB 
is created if required- 

• RET=NONE (or parameter left blank) 

no return code is set by the routine; 
control blocks are constructed as for 
RET=USE. 

When the required action is complete, the 
routine branches to the pre- exit subroutine 
described below, or begins again with the 
queue search if additional requests are to 
be processed. 



Pre- Exit 



Subroutine: 



This 



subroutine 

(TESTEND1 and TESTEND2 in CSECT IGC048) is 
entered to determine if the calling task 
can proceed. The task can always proceed 
if the RET=TEST parameter was used. Reg- 
ister 15 is set and control is returned to 
the task. If the SVRB wait count is not 
zero, the registers are saved in the TCB, 



the resume PSW is set to the address of the 
SMC test, the new PSW is set to zero, and 
the routine then branches to the dispatch- 
er. The return codes are set and control 
is returned to the calling task if the SVRB 
wait count is zero and must-complete is not 
requested. If must-complete is requested, 
the routine proceeds as described below. 

If the specified major QCB is found, the 
routine searches the major QCB's queue of 
minor QCBs for the specified minor name. 
If the minor QCB is not found, a return 
code is set and/or control blocks are 
created as explained above. If the minor 
QCB is found the queue elements queued on 
the minor QCB are searched for another 
queue element for the enqueueing task 
chained to the same minor QCB. Such a 
duplicate queue element indicates that the 
task has attempted to enqueue twice on the 
same resource without an intervening 
dequeue. If a duplicate request is encoun- 
tered, the routine causes the task to be 
abnormally terminated unless the new 
request is an inquiry (RET=HAVE, USE, or 
TEST) . If the request is an inquiry, a 
return code of 08 is set and a subroutine 
is entered to determine whether the request 
includes a must-complete requirement. 

For a non-duplicate request, the routine 
determines whether all queue elements 
already enqueued on the minor QCB are 
"shared" and whether this is also a 
"shared" request. If both conditions are 
true, a queue element is created, the count 
field in the TCB (TCBCT) is incremented by 
one for each resource enqueued upon, and a 
return code is set and/or QCBs are created 
as explained above. 

If a queue element representing an 
"exclusive" request is already enqueued on 
the resource, the wait count in the SVRB 
associated with the new request is incre- 
mented by one. This wait count, which will 
be decremented by the dequeue service rou- 
tine when the exclusive request is satis- 
fied, causes the requesting task to wait in 
the enqueue routine but does not affect the 
dispatchability of the task as a whole. 
Asynchronous routines, called by IRBs added 
to the TCB f s request block chain, can still 
operate under the task's control. 

The wait count is not incremented if the 
RET=USE parameter was included. In that 
case, the routine sets the "resource in 
use" return code and processes any further 
requests or proceeds to the pre- exit sub- 
routine. 

If must-complete was specified and the 
requesting task is a system task (rather 
than a user task, which would be abnormally 
terminated if 'set-must- complete' were 
specified) , the subroutine sets on the 
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must*- complete flag in the queue element and 
waits until any preceding requests on the 
queue have been dequeued. During this 
period the must- complete condition is not 
in effect. The flag in the queue element 
is set on to indicate that the condition is 
to be imposed, but only after use of the 
resource has actually begun. 

When the queue element containing the 
must- complete flag reaches the top of the 
resource queue — that is, when the 
resource becomes available to the task that 
requested the resource and the must- 
complete restriction — the step or system 
must-complete flag is set on in the task's 
TCB and all other TCBs in the system are 
made non-dispatchable. This ensures that 
the task that imposed the must- complete 
restriction will be the only task operating 
until the restriction is lifted, through 
issuance of a release-must-complete in that 
task. 

An exception arises if the system 
interrupt request block (SIRB) has been 
placed in the RB chain of another task. In 
that case, the task under which the SIRB is 
running is not set non-dispatchable, but a 
flag is set on in the exit routine of the 
supervisor's exit and transient area han- 
dler. The two tasks operate concurrently 
until the restriction is lifted by the 
responsible task (upon DEQ) , or the task 
under which the SIRB is being serviced 
exits. Exit from the SIRB causes the task 
for which non-dispatchability was deferred 
to be set non-dispatchable. 

Dequeue Service Routine 

The dequeue service routine (see Charts 
23 through 25) is entered through the SVC 
second- level interrupt handler in response 
to a DEQ (SVC 48) , or through a branch from 
a system routine. The function of the 
dequeue service routine is to remove from 
the list of pending requests a request that 
has been satisfied, and to cause the next 
request (if any) on the list to be ser- 
viced. In addition, the routine resets the 
must- complete condition when a reset is 
specified by a system task. 

After performing initial validity checks 
(Chart 26) , the routine searches the major 
and minor QCB queues for the control blocks 
corresponding to the major and minor names 
specified by the requester. If the 
required QCBs are not found, the action 
taken is determined by the value of the 
RET=parameter : 

• If RET=HAVE, the request was condi- 
tional. A return code of 08 is set to 
indicate that the task in which the DEQ 
was issued was never enqueued upon the 
resource, and the routine proceeds to 



check for more parameter list entries 
to process. 



• If RET=NONE or the parameter was omit- 
ted, the task in which the DEQ was 
issued is abnormally terminated with an 
error code of 130. 

If the specified major QCB and minor QCB 
are found, the queue elements enqueued on 
the minor QCB are examined to determine 
whether a dequeue can be performed, and 
whether, if a dequeue cannot be performed, 
a return code is to be provided or the 
dequeueing task is to be abnormally termi- 
nated. 

A dequeue can be performed if the queue 
element enqueued by the task issuing the 
dequeue request is: 

• An exclusive request at the head of the 
queue , or 

• A shared request in any position 
preceding the first exclusive request 
on the queue. 

If either of those two conditions is met, 
the routine proceeds to dequeue the ele- 
ment. 

If these conditions are not met, there 
are two possibilities: either the queue 
element being sought by the dequeueing task 
is not in the queue, or it is in the queue 
but has never been serviced. If the queue 
element is not in the queue, the routine 
sets a return code of 08 and continues if 
RET=HAVE was specified, or abnormally ter- 
minates the dequeueing task. If the ele- 
ment is in the queue but has never been 
serviced, the routine: 

1. sets a return code of 04 and proceeds 
to the next item in the parameter list 
or 

2. abnormally terminates the task 

depending on the RET= parameter. The 04 
return code in this case indicates that the 
request was not at the top of the queue and 
is exclusive, or is shared but is preceded 
on the queue by an exclusive request. 

When a queue element to be dequeued is 
found, the count field in the TCB (TCBCT) 
is decremented by one and the queue element 
is removed from the queue. The TCBCT field 
is a record of the number of outstanding 
requests associated with the task. The 
count is incremented by 1 for each resource 
enqueued upon when the task issues an ENQ 
and decremented by 1 for each resource 
dequeued when a DEQ is issued by the task. 
This field is referred to, if the task is 
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abnormally terminated, to determine when 
all outstanding requests have been purged. 

If there are no more requests remaining 
on the minor QCB's queue after the queue 
element is dequeued, the minor QCB itself 
is dequeued from the major QCB; similarly, 
if no additional minor QCBs remain, the 
major QCB is removed from the chain of 
major QCBs. A FREEMAIN is then issued, 
releasing the main storage formerly occu- 
pied by the removed control blocks. 

The presence of another queue element 
after the element removed through the DEQ 
means that the resource is now to be made 
available to the next enqueued task(s). If 
the next queue element represents an exclu- 
sive request, the DECSVRB subroutine is 
entered (see below) to enable the request- 
ing task to receive control. If the next 
queue element represents a shared request 
and the previous queue element was exclu- 
sive, the same function is performed not 
only for the task associated with the 
shared queue element, but for all subse- 
quent shared tasks in the queue as well, 
until the end of the queue or an exclusive 
request is reached. After preparing for 
the receipt of control by the necessary 
task or tasks, the routine frees the main 
storage used for any removed control blocks 
and proceeds. 

The DECSVRB subroutine (Chart 25) deals 
with a queue element that has just become 
the first element of the resource queue, or 
with a shared queue element not preceded by 
an exclusive request and therefore effec- 
tively at the top of the queue. The wait 
count in the SVRB associated with the queue 
element is examined. If the wait count is 
already zero (not the normal case) , the 
subroutine exits. Otherwise, the wait 
count is decremented by one. If this does 
not reduce the wait count to zero, the 
enqueued task is still waiting for other 
resources and cannot, therefore, receive 
control; the subroutine exits. But if the 
wait count in the SVRB does reduce to zero, 
the enqueued task now has available to it 
all of the resources it requires and can 
receive control. A task switch is effected 
if the now-ready task is of higher priority 
than the task (pointed to by the NEW task 
control block address pointer in the com- 
munication vector table) last in control. 
If the enqueued task is of lower priority, 
no task switch occurs. In either case, 
however, the zero SVRB wait count makes it 
possible for the task to proceed when next 
dispatched. 

After the FREEMAIN operation for removed 
control blocks is complete, the routine 
loops back to process any further elements 
on the parameter list, or proceeds to reset 
must-complete (if required), check for 



return codes, and exit. Exit takes one of 
two paths: either to the caller (the task 
in which the DEQ was issued) , or to the 
newly ready task (the task in which the ENQ 
was originally issued) . If the contents of 
NEW have been changed by the dequeue rou- 
tine, the dispatcher performs the required 
task switch by giving control to the rou- 
tine in which the ENQ had been issued. 

Major and minor QCB's are moved to the 
partition represented by the next QEL when 
they reside in the partition that is issu- 
ing the DEQ. (See Figure 8.) 



DADSM MODIFICATIONS 

To provide volume table of contents 
(VT0C) integrity in a multi-task environ- 
ment, the DADSM allocate, extend, scratch, 
and release routines use the ENQ and DEQ 
macro-instructions and the must-complete 
options thereof to ensure that no task 
other than the task performing a VT0C 
update will access the VTOC while the 
update is in progress. The manner in which 
the ENQ and DEQ macro-instructions are used 
is summarized below. For further informa- 
tion on those routines, refer to the publi- 
cation IBM System/360 Operating System: 
Direct- Access Device Space Management, Pro- 
gram Logic Manual ; Form Y28-6607. 

Note: Except where specifically noted, the 
resource to which ENQ and DEQ requests 
relate is the VTOC for the volume upon 
which the DADSM routines are operating. 

Allocate Routines — Non- Indexed Sequential 
Data Sets 

On entry to the allocate routine, an ENQ 
is issued by the duplicate name search 
routine. The must-complete condition is 
subsequently set in (1) the sub-allocation 
routine, or (2) the DSCB creation routine. 
A DEQ is issued and the must- complete 
condition is reset in the VTOC updating 
routine. 

Allocate Routines — Indexed Sequential 
(ISAM) Data Sets 

An ENQ is issued by the duplicate name 
search routine. The must-complete condi- 
tion is set in either (1) the DSCB build 
routine, (2) the duplicate format 1 action 
routine, or (3) the embedded index routine. 
A DEQ is issued and the must-complete 
condition is reset by the completion of 
processing routine. 

If additional volumes are to be process- 
ed, an ENQ specifying the VTOC for the next 
volume is issued before the allocate rou- 
tines are re-entered for that volume. 
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Extend Routines 

An ENQ is issued and the must- complete 
condition is set by the duplicate name 
search routine. The VTOC updating issues a 
DEQ and resets the must-complete condition. 

Scratch Routine 

An ENQ is issued and the must- complete 
condition is set by the UCB search routine; 
DEQ is issued and the must-complete condi- 
tion is reset by the VTOC updating routine. 



This process is repeated on each pass 
through the routine for a multi- volume data 
set. 

Release Routine 

An ENQ is issued and must -complete con- 
dition is set by the first module of the 
release routine. DEQ is issued and must- 
complete condition is reset by the close 
routine of I/O Support, to which the 
release routine transfers control when VTOC 
updating is complete. 
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LOAD MODULES AND ASSEMBLY MODULES 



This section lists job management load 
modules and indicates the assembly modules 
that are processed by the linkage editor 
into each load module during system genera- 
tion. Included is a separate list that 
shows the load modules in which each assem- 
bly module is contained. 



Job management routines for Option 2 of 
the control program are packaged in two 
configurations: 18K and 44K (where K is 
1024 bytes of main storage) . The numbers 
represent the maximum amount of main stor- 
age occupied by job management routines and 
work areas at any time. Both job manage- 
ment configurations function identically 
but differ in both the number of load 
modules and the number of assembly modules 
within each load module. 



The configuration 
eration determines 
size in the Option 2 
ment routines occupy 
storage alternately 
grams, therefore the 
mines the minimum si 
partition. 



chosen at system gen- 
the minimum partition 
system. Job manage- 
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LOAD MODULES 

In each configuration, all load modules 
are contained in three data sets: 
SYS1. NUCLEUS, SYS1.SVCLIB and SYS1. LINKLIB. 
These data sets also contain other parts of 
the control program. The .load modules in 
the first two data sets remain the same for 
both job management configurations, but the 
SYS1. LINKLIB data set contains a different 
set of load modules for .each configuration, 
depending on which one was selected at 
system generation time. In the 18K con- 
figuration, LINKLIB contains 36 load 
modules; in the 44K configuration, it con- 
tains 25 load modules. 

Charts 27 and 28 show the control flow 
among load modules. The decision to trans- 
fer control (XCTL) to a particular succeed- 
ing load module is made in the previous 
load module. Each subsequent module loaded 
in response to an XCTL macro-instruction is 
read into main storage directly over the 
previous load module. Such load modules 
are read into the low-numbered end of the 
partition in which job scheduling is being 
performed. 



Modules that are brought into storage 
with LINK macro-instructions and LOAD 
macro-instructions occupy separate storage 
areas within the partition? such modules 
are shown on the control-flow charts. 
Because storage is used in this manner, the 
load module lists may be used with chart 27 
or 28 to determine the approximate layout 
of a partition at different times during 
the execution of job management routines. 
Other items present in the partition at the 
same time as the load modules are not shown 
on the control flow charts because, 
although these items are necessary, control 
is not passed among them. They are, gener- 
ally, the tables and control blocks, work 
areas, access methods, buffers, and reg- 
ister save areas. 

In the following load module lists, 
entry points are shown if a load module 
contains more than one assembly module. If 
only one assembly module is named, the 
entry point is the same as the assembly 
module's control section (CSECT) name given 
in the Assembly Modules and Control Sec- 
tions table in this section. 



LOAD MODULES CONTAINED IN THE SYS1. NUCLEUS 
DATA SET 

The load modules and assembly modules in 
the following list are contained in the 
SYS1. NUCLEUS data set, and are always pre- 
sent in the nucleus, or system area of main 
storage, regardless of the job management 
configuration. 

Load Module Name: SYS1. NUCLEUS 

Assembly Modules: 

IEEBC1PE External interrupt routine. 

IEECIR01 Console interrupt routine. 

IEERSC01 Master scheduler buffers, 

switches, input/output block 
(IOB), event control block 
(ECB) , channel control word 
(CCW) , and device end block 
(DEB) . This load module forms 
master scheduler resident main 
storage in the nucleus area when 
the primary or alternate console 
(1052) is used. 

IEERSR01 Master scheduler buffers, 

switches, IOB, ECB, CCW, and 
DEB. This load module forms 
master scheduler resident main 
storage in the nucleus area when 
the composite console is used. 
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IEFDPOST Unsolicited-interrupt routine. 

MCONRESA Table store subroutine work 
area, 

IEECVCRX External Interrupt Routine 
(Option 2) 

IEECVCRA Console Interrupt Routine 
(Option 2) 

IEECVUCM Communication Task buffers, 

switches, input/ output blocks 
( IOB) f event control blocks 
(ECB) f device end blocks (DEB), 
and data control blocks (DCB) . 
This data area is used for oper- 
ator communication in Option 2 
systems . 

IEECVPRG Operator communication reply 
queue purging routine (Option 
2). 

IEECVCTW Communication Task Wait Module, 



LOAD MODULES CONTAINED IN THE SYS1.SVCLIB 
DATA SET 

The load modules and assembly modules in 
the following list are contained in the 
SYS1.SVCLIB data set, and are called in 
response to SVC instructions. 

Load Module Name: IGC0003D 

Assembly Modules: 

IEEMXC01 Master command EXCP routine 

(Part 1) — primary /alternate 

console. 
IEEMXR01 Master command EXCP 

routine (Part 1) — composite 

console. 
IEEMCP01 Option 2 Master Command EXCP 

routine (overlay module) . 

Load Module Name: IEE1203D 
Assembly Module: 

IEE1203D Option 2 Master Command Reply 
Processor (overlay module). 

Load Module Name: IGC0007B 
Assembly Module: 

IEECVCTR Communication Task Router 
module . 



Load Module Name: IGC2103D 

Assembly Module: 

IEECVPMP Option 2 Communication Task 

Process module — access method 

BSAM (1443). 

Load Module Name: IGCQI03D 
Assembly Module: 

IEECVOCX Option 2 Console unit initiali- 
zation EXCP input/ out put. 

Load Module Name: IGC1I03D 
Assembly Module: 

IEECVOCC Option 2 Console unit initiali- 
zation BSAM input. 

Load Module Name: IGC2I03D 
Assembly Module: 

IEECVOCP Option 2 Console unit initiali- 
zation BSAM output. 

Load Module Name: IGCX07B 

Assembly Module: 

IEECVCTX Option 2 Communication Task 

external interrupt processor. 

Load Module Name: IGC0003E 

Assembly Modules: 

IEEWTC01 Write-to-operator (WTO) routine 

— primary /alternate console. 
IEEWTR01 Write-to-operator (WTO) routine 

— composite console. 
IEECVWTO Option 2 WTO/WTOR queueing rou- 
tine. 

Load Module Name: IGC0103D 

Assembly Module: 

IGC0103D Master command EXCP routine 

(Part 2) , or command processing 

routine. 
IGC0113D Option 2 Master Command EXCP 

routine (overlay module). 

Load Module Name: IGC0003F 
Assembly Module: 

IEEBH1PE Not used in sequential schedul- 
ing system. 



Load Module Name: IGC0107B 

Assembly Module: 

IEECVPMX Option 2 Communication Task 

Process module — access method 

EXCP (1052). 

Load Module Name: IGC0113D 

Assembly Module: 

IEECVPMC Option 2 Communication Task 

Process module — access method 

BSAM (2540) . 



MODULES CONTAINED IN THE SYS1.LINKLIB DATA 
SET 

The load modules and assembly modules in 
the following lists are contained in the 
SYS1.LINKLIB data set. A list is provided 
for both of the packaging configurations in 
which job management routines are avail- 
able. 
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Load Module Name: IEECVCTI 

Assembly Modules: 

IEECVCTI Option 2 Communication Task 

Initialization routine, 
IEEVRFRX Option 2 CVT, TCB, RB f TIOT f and 

UCB look-up module. 

Load Module Name: IEFSTERM 

Alias: IEFYN 

Alias : GO 

Entry Point: IEFSD034 

Assembly Modules: 

IEFSD011 Entry to job management from 
supervisor. 

IEFW42SD Passes control to IEFIDUMP (in 
IEFIDUMP Load Module) if neces- 
sary, or to IEFYNIMP (in this 
module) . 

IEFYNIMP Step termination routine. 

IEFYPJB3 Step data set driver routine. 

IEFVJIMP Job statement condition code 
routine. 

IEFZGST1 Disposition and unallocation 
subroutine. 

IEFACTLK Linkage to user's accounting 
routine. 

IEFACTRT Dummy, to be replaced by user's 
accounting routine. 

(The preceding two modules may be replaced 

by IEFACTFK assembly module if no account- 
ing routine is specified as a system gene- 
ration option.) 

IEFSD017 Places logical track address 
(TTR) of first system message 
block (SMB) into job control 
table ( JCT) . 

IEFW22SD Passes control to IEFYNIMP (in 
this load module) , then to 
IEFSD002 (in this load module) 
or to IEFZAJB3 (in IEFJTERM load 
module) . 

IEFSD002 Exit to IEF08FAK or IEF09FAK 
(both in this load module). 

IEFSD006 Converts record number to logi- 
cal track address (TTR). 

IEFSD007 Call to table store subroutine. 

IEFSD03U Pre- termination exits to 
IEFSD011 

IEFYSSMB Message enqueuing routine, 
enqueues SMBs. 

IEFQMSSS Table store subroutine. 

IEFVJMSG Contains initiator terminator 
messages. 

IEFYNMSG Contains initiator terminator 
messages. 

IEFYPMSG Contains initiator terminator 
messages. 

IEFZGMSG Contains initiator terminator 
messages. 

IEFZHMSG Contains initiator terminator 
messages . 



IEFIDFAK Linkage to IEFIDUMP (in IEFIDUMP 

load module) . 
IEFZAFAK Linkage to IEFZAJB3 (in IEFJTERM 

load module) . 
IEF08FAK Linkage to IEFSD008 (in IEFINTFC 

load module) . 
IEF09FAK Linkage to IEFSD009 (in IEFSELCT 

load module) . 

Load Module Name: IEFSELCT 
Alias: IEFSD009 
Entry Point: IEFSD009 
Assembly Modules: 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD009 Initializes 

initiator/terminator. 
IEFW21SD System control routine. 
IEFVKIMP Execute statement condition code 

routine. 
IEFVMLS1 JFCB housekeeping control rou- 
tine. 
IEFVM2LS JFCB housekeeping fetch DCB 

routine. 
IEFVM3LS JFCB housekeeping generation 

data group (GDG) single routine. 
IEFVMULS JFCB housekeeping generation 

data group (GDG) all routine. 
IEFVM5LS JFCB housekeeping patterning 

data set control block (DSCB) 

routine. 
IEFVM76 Processes passed, non-labeled 

tape data sets. 
IEFWSTRT Job started message routine. 
IEFYSSMB Message enqueuing routine, 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFWMAS1 Device name table. 
IEFVKMSG Contains initiator terminator 

messages. 
IEFVMLK5 Linkage to IEFVMLS6 (in IEFERROR 

load module) . 
IEFXAFAK Linkage to IEFXCSSS (in IEFALOC1 

load module) . 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFALOC1 

Alias: IEFXJOOO 

Alias : IEFXA 

Entry Point: IEFXA 

Assembly Modules: 

IEFXCSS Allocation control routine. 

IEFXJIMP Allocation error recovery rou- 
tine. 

IEFYSSMB Message enqueuing routine. 

IEFQMSSS Table store subroutine. 

IEFXAMSG Contains initiator terminator 
messages. 

IEFXJMSG Contains initiator terminator 
messages. 
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IEFWAFAK Linkage to IEFWA000 (in IEFALOC2 

load module) . 
IEFWCFAK Linkage to IEFWCIMP (in IEFALOC3 

load module) . 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFALOC2 

Alias: IEFWA000 

Entry Point: IEFWA000 

Assembly Modules: 

IEFWAOOO Demand allocation routine. 

IEFWSWIN Passes control to decision allo- 
cation or automatic volume 
recognition (AVR) routine. 

IEFX5000 Decision allocation routine. 

IEFX300A Device strikeout routine. 

IEFXH000 Separation strikeout routine. 

IEFWMSKA Device mask table. 

IEFWCFAK Linkage to IEFWCIMP (in IEFALOC3 
load module) . 

IEFXJFAK Linkage to IEFXCSSS (in IEFALOC1 
load module) . 

IEFS15XL Check for duplicate allocation. 



Load Module Name: IEFALOC3 

Alias: IEFWC000 

Entry Point: IEFWC000 

Assembly Modules: 

IEFWCIMP Task Input/Output Table con- 
struction routine. 

IEFXHOOO Separation strikeout routine. 

IEFWDFAK Linkage to IEFWDOOO (in IEFALOC4 
module) . 

IEFXJFAK Linkage to IEFXCSSS (in IEFALOC1 
module) . 

Load Module Name: IEFALOC4 

Alias: IEFWDOOO 

Entry Point: IEFWDOOO 

Assembly Modules: 

IEFWDOOO External action routine. 

IEFWD001 Message directory for external 

action routine. 
IEFXTOOD Space request routine. 
IEFXKIMP Allocation error nonrecovery 

routine. 
IEFXTDMY Queue overflow routine. 
IEFYSSMB Message enqueuing routine, 

enqueues SMBs . 
IEFQMSSS Table store subroutine. 
IEFXKMSG Contains initiator terminator 

messages. 
IEFXTM^G Contains initiator terminator 



IEFW41SD 



messages. 

Exit to IEF04FAK (in this load 

module) . 

IEF04FAK Linkage to IEFSD004 (in IEFATACH 
load module) . 

IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 
load module) . 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

Load Module Name: IEFATACH 
Alias: IEFSD004 
Entry Point: IEFSD004 



Assembly Modules: 

IEFSD004 Step initiation routine, with 
exit to processing program. 

IEFSD006 Converts record number to logi- 
cal track address (TTR). 

IEFSD007 Call to table store subroutine. 

IEFSD010 Dequeues and writes out system 
message blocks (SMBs) . 

IEFQMSSS Table store subroutine. 

Load Module Name: IEFCNTRL 

Alias: IEF5DDHD 

Alias : IEFMF 

Alias: IEFMC 

Alias: IEFKA 

Entry Point: INDMRTN 

Assembly Modules: 

IEF7KAXX Reader/interpreter control rou- 
tine. 

IEF6DDHD DD routine. 

IEF6BOCM Breakout routine. 

IEF6MFXX Verb identification routine. 

IEF6MCXX Scans job control language (JCL) 
statements . 

IEF6STNM Scan stepname routine. 

IEF6NAME Qualified name routine. 

IEF6FRRS Resolves DD forward references. 

IEF6DCB0 DCB refer- back routine. 

IEF6MKXX Continuation routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEFK4DUM Linkage to IEFK4ENT (in IEFK4 
load module) . 

IEF6DHX1 Linkage to IEF6SCAN (in IEFDD 
load module) . 

IEFKLDUM Linkage to IEF6KLXX (in IEF1STMT 
load module) . 

IEFJMDUM Linkage to IEF6NCJB (in IEFJOB 
load module) . 

IEFEMDUM Linkage to IEF6NJEX (in IEFEXEC 
load module) . 

IEF60UT2 DD output routine, with exit to 
IEF7KAXX (in this load module). 

IEFKGDUM Linkage to IEF7KGXX (in IEFINTFC 
load module) . 

IEFKPDUM Linkage to IEF7KPXX (in IEFCOMND 
load module) . 

IEFK3DUM Linkage to IEF7K3XX (in IEFEOF 
load module) . 

Load Module Name: IEFDD 

Alias : IEF5SCAN 

Entry Point: INDMON 

Assembly Modules: 

IEF6SCAN DD scan routine. 

IEF6BOCM Breakout routine. 

IEFSD012 DD* statement routine. 

IEF6DDNM DD name routine. 

IEF6DSNM DS name routine. 

IEF6RFWD Processes DD forward references. 

IEF6RTPR Right parenthesis routine. 

IEF6LFPR Left parenthesis routine. 

IEF6EQUL Equal sign routine. 
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IEF6LIST Subparameter list routine. 

IEF6NLST Routine for no subparameter 
list, 

IEF6NDDP DD parameter list table. 

IEF6DCDP Data control block (DCB) DD 
parameter list table. 

IEFSD013 Assigns unit to system output 
(SYSOUT). 

IEF60RDR Order subroutine. 

IEF6INST Insert routine. 

IEF6VALU Value subroutine. 

IEF6CLNP Clean up after DD routine. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEF6ERR1 DD error- handling routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS 

IEFQMSSS Table store subroutine. 

IEF6CN17 Linkage to IEF6DDHD (in IEFCNTRL 
load module) . 



Load Module Name: IEFINTFC 

Alias: IEFSD008 

Alias: IEFSD001 

Alias: IEFKG 

Entry Point: IEFSD008 

Assembly Modules: 



IEFSD008 

IEF7KGXX 
IEFSD006 

IEFSD007 
IEEMCS01 
IEF7MMCM 

IEF6MIXX 

IEFQMSSS 
IEFSD001 



IEF09FAK 



IEF23FAK 



IEFMFDUM 



IEFKADUM 



IEFK3DUM 



Initiator/terminator to 
reader/interpreter interface. 
Output tables for step. 
Converts record number to logi- 
cal track address (TTR) . 
Call to table store subroutine. 
Master command routine. 
Reader/interpreter message rou- 
tine. 

Reader/interpreter call to 
IEFQMSSS. 

Table store subroutine. 
Reader/interpreter entry to 
IEF09FAK or to IEFW23SD (both in 
this load module) . 
Linkage to IEFSD009 (in IEFSELCT 
load module) . 

Linkage to IEFW23SD (in IEFJTERM 
load module) . 

Linkage to IEF6MFXX (in IEFCNTRL 
load module) . 

Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

Linkage to IEF7K3XX (in IEFEOF 
load module) . 



Load Module Name: IEFEXEC 
Alias: IEFEM 
Entry Point: IEFEM 
Assembly Modules: 

IEF6NJEX Execute (EXEC) statement rou- 
tine. 
IEF6BOCM Breakout routine. 
IEF6STNM Scan stepname routine, 
IEF6NAME Qualified name routine. 
IEF6RFBK Refer-back routine. 
IEF6PR0C Procedure name routine. 
IEF6TIME TIME keyword routine. 



IEF6COND Condition (COND) keyword rou- 
tine. 

IEF6PARM Parameter (PARM) keyword rou- 
tine. 

IEF6NFCM Accounting information routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEF8LINK Linkage to IEF6C0ND (in this 
module) . 

IEFMFDUM Linkage to IEF6MFXX (in IEFCNTRL 
load module) . 

Load Module Name: IEFJOB 

Alias : IEFJM 

Entry Point: IEFJM 

Assembly Modules: 

IEF6NCJB Job (JOB) statement routine. 

IEF6BOCM Breakout routine. 

IEF6STNM Scan stepname routine. 

IEF6NAME Qualified name routine. 

IEF6NFCM Accounting information routine. 

IEF6NIJB TYPRUN keyword routine. 

IEF6NYJB Priority (PRTY) keyword routine. 

IEF6COND Condition (COND) keyword rou- 
tine. 

IEF6NXJB Message level (MSGLEVEL) keyword 
routine. 

IEF6NZJB Message class (MSGCLASS) keyword 
routine. 

IEF6NIJB Parenthesis routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader /interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEFMFDUM Linkage to IEF6MFXX (in IEFCNTRL 
load module) . 

Load Module Name: IEFJTERM 

Alias: IEFW23SD 

Alias : IEFZA 

Entry Point: IEFZA 

Assembly Modules: 

IEFW23SD Initializes for job termination, 

exits to IEFZAJB3 (in this load 

module) . 
IEFZAJB3 Job termination routine. 
IEFWTERM Job ended message routine. 
IEFZGJB1 Disposition and unallocation 

subroutine. 
IEFACTLK Linkage to user's accounting 

routine. 
IEFACTRT Dummy module to be replaced by 

user's accounting routine. 
(The preceding two modules may be replaced 
by IEFACTFK assembly module if no account- 
ing routine is specified as a system gene- 
ration option. ) 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD007 Call to table store subroutine. 
IEFYSSMB Message enqueuing routine, 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFZHFAK Call to ZP0QMGR1 subroutine. 
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IEFZGMSG Contains initiator terminator 

messages. 
IEFZHMSG Contains initiator terminator 

messages, 
IEFW31SD Exit to IEFSD003 (in this load 

module) . 
IEFSD003 Passes control to IEFSD010, then 

to IEF08FAK, (both in this load 

module) . 
IEFSD010 Dequeues and writes out system 

message blocks (SMBs). 
IEFSD035 Check for downshift (exit to 

IEFSD031). 



Load Module Name: IEFK4 
Entry Point: IEFK4DUM 
Assembly Modules: 

IEFK4ENT Switch input readers routine, 
IEF7K4XX Close devices routine, 
IEF7K2XX Open devices routine, 
IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD007 Call to table store subroutine, 
IEF6MIXX Reader/interpreter call to 

IEFQMSSS. 
IEFQMSSS Table store subroutine, 



Load Module Name: IEFCOMND 

Alias: IEFKP 

Entry Point: IEFKP 

Assembly Modules: 

IEF7KPXX Processes commands in input 
stream, 

IEEMCS01 Master command routine. 

IEEILCDM Prevents unresolved IEEICCAN 
symbol after initialization. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

Load Module Name: IEF1STMT 

Alias: IEFKL 

Entry Point: IEFKL 

Assembly Modules: 

IEF6KLXX First statement routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEFMCDUM Linkage to IEF6MCXX (in IEFCNTRL 
load module) . 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

Load Module Name: IEFEOF 

Alias: IEFK3 

Entry Point: IEFK3 

Assembly Modules: 

IEF7K3XX Input stream end-of-file (EOF) 
routine, 

IEF7K4XX Close devices routine. 

IEF7K2XX Open devices routine. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) , 

IEFSD007 Call to table store subroutine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEEMCS01 Master command routine. 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

IEEILCDM Prevents unresolved IEEICCAN 
symbol after initialization 
(IPL). 



Load Module Name: IEFERROR 

Alias: IEFVM6LS 

Entry Point: IEFVMSGR 

Assembly Modules: 

IEFVMLS6 JFCB housekeeping error message 

processing routine. 
IEFYSSMB Message enqueuing routine 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFVMLS7 Contains initiator/terminator 

messages. 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFIDUMP 

Entry Point: IEFIDUMP 

Assembly Modules: 

IEFIDUMP Indicative dump routine. 

IEFYSSMB Message enqueuing routine, 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFIDMPM Contains initiator/terminator 

messages. 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFDCB 
Alias: IEF5DCDP 
Assembly Module: 

IEF6DCDP Data control block (DCB) DD 
parameter list table. 

Load Module Name: IEFMSG01 
Assembly Module: 

IEF3MSG1 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG02 
Assembly Module: 

IEF3MSG2 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG03 
Assembly Module: 

IEF3MSG3 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSGOU 
Assembly Module: 

IEF3MSG4 Contains reader/interpreter 
messages. 



Load Module Name: 
Assembly Module: 



IEFMSG05 
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IEF3MSG5 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG06 
Assembly Module: 

IEF3MSG6 Contains reader/ interpreter 
messages. 

Load Module Name: IEFMSG07 
Assembly Module: 

IEF3MSG7 Contains reader/interpreter 
messages. 

Load Module Name: IEFINITL 

Alias: IEFK1 

Assembly Modules: 

IEF7K1XX Entry to job management from 

nucleus initialization program 
(NIP). 

IEEMCS01 Master command routine. 

IEEILC01 Automatic command routine. 

IEF7K2XX Open devices routine. 

IEFWSDIP Linkage control table (LCT) 
initialization routine. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEFSD007 Call to table store subroutine. 

IEF6MIXX Reader/interpreter call to 
IEFQMSSS. 

IEFQMSSS Table store subroutine. 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 



Load Module Name: 



IEESET 



Alias: IEEGESTO 
Assembly Module: 

IEEGES01 Master scheduler SET command 
routine. 

Load Module Name: IEFJOBQE 
Alias : IEFINTQS 
Assembly Module: 

IEFINTQA Initializes SYS1 . SYS JOBQE data 
set. 



Load Module Name: 



IEETIME 



Alias: IEEQOT00 
Assembly Module: 
IEEQOT00 Sets time and date. 



Load Module Name: IEEFAULT 
Alias : IEEGK1GM 
Assembly Module: 

IEEGK1GM Fault routine — issues master 
scheduler messages. 



Load Module Name: IEESTART 

Alias : IEEIC1PE 

Entry Point: IEEIC1PE 

Assembly Modules: 

IEESTART START command routine. 

IEEREADR Start reader routine. 

IEEWRITR Start writer routine - 

Load Module Name: IEEJFCB 
Alias : IEEIC3 JF 
Assembly Module: 

IEEIC3JF Contains preformatted JFCB for 
one START command. 

Load Module Name: IEESJFCB 

Alias : IEEIC2NQ 

Entry Point: IEEIC2NQ 

Assembly Modules: 

IEEIC2NQ Saves START command JFCBs. 

IEFQMSSS Table store subroutine. 

Load Module Name: IEFSD030 
Assembly Modules: 

IEFSD030 Scheduler downshift routine. 
IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD007 Call to table store subroutine. 
IEFSQMSS Table store subroutine. 

Load Module Name: IEFSD031 
Assembly Modules: 

IEFSD031 Scheduler upshift routine. 
IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD007 Call to table store subroutine. 
IEFSQMSS Table store subroutine. 

Load Module Name: IEFPRINT 

Alias : SPRINTER 

Alias : IEFPRT 

Assembly Module: 

IEFPRTXX Tape SYSOUT to printer. 
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Load Module Name: IEECVCTI 

Assembly Modules: 

IEECVCTI Option 2 Communication Task 

Initialization routine. 
IEEVRFRX Option 2 CVT, TCB, RB, TIOT, 

UCB look-up module. 



Load Module Name: IEFSTERM 

Alias: IEFYN 

Alias: IEFSD009 

Alias : GO 

Entry Point: IEFSD034 



Assembly Modules: 



and 



IEFSD011 



IEFW42SD 



IEFYNIMP 
IEFYPJB3 
IEFVJIMP 

IEFVZGST1 



Entry to job management from 
supervisor. 

Passes control to IEFIDUMP (in 
IEFIDUMP load module) if indica- 
tive dump is needed, or to IEF- 
YNIMP (in this load module) . 
Step termination routine. 
Step data set driver routine. 
JOB statement condition code 
routine. 

Disposition and unallocation 
subroutine. 
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IEFACTLK Linkage to user's accounting 

routine. 
IEFACTRT Dummy user's accounting routine, 
IEFSD017 Places logical track address 

(TTR) of first system message 

block (SMB) in job control table 

(JCT). 
IEFW22SD Passes control to IEFYNIMP (in 

this load module) , and then to 

IEFSD002 (in this load module) 

or to IEFZAJB3 (in IEFCNTRL load 

module) . 
IEFSD002 Exit to IEF08FAK or IEFSD009 

(both in this load module). 
IEFSD009 Initiator/terminator 

initialization of output unit, 

passes control to IEFW21SD (in 

this load module) . 
IEFSD034 Pre- termination (exits to 

IEFSD011) . 
IEFW21SD System control routine. 
IEFVKIMP EXEC statement condition code 

routine. 
IEFVMLS1 JFCB housekeeping control rou- 
tine. 
IEFVM2LS Fetch DCB routine. 
IEFVM3LS GDG single routine. 
IEFVM4LS GDG all routine. 
IEFVM5LS Patterning DSCB routine. 
IEFVM76 Processes passed non- labeled 

tape data sets. 
IEFWSTRT Job started message routine. 
IEFWMAS1 Device name table. 
IEFSD006 Converts record number to logi- 
cal track address (TTR). 
IEFSD007 Call to table store subroutine. 
IEFYSSMB Message enqueuing routine 9 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFVJMSG Contains initiator/terminator 

messages. 
IEFVKMSG Contains initiator/terminator 

messages. 
IEFYNMSG Contains initiator/terminator 

messages. 
IEFYPMSG Contains initiator/terminator 

messages. 
IEFZGMSG Contains initiator/terminator 

messages. 
IEFZHMSG Contains initiator terminator 

^ messages. 
IEFIDFAK Linkage to IEFIDUMP (in IEFIDUMP 

load module) . 
IEFVMLK5 Linkage to IEFVMLS6 (in IEFERROR 

load module) . 
IEFXAFAK Linkage to IEFXCSSS (in IEFALLOC 

load module) . 
IEFZAFAK Linkage to IEFZAJB3 (in IEFCNTRL 

load module) . 
IEF08FAK Linkage to IEFSD008 (in IEFCNTRL 

load module) . 



Load Module Name: IEFALLOC 

Alias: IEFXA 

Entry Point: IEFXA 

Assembly Modules: 

IEFXCSSS Allocation control routine. 



IEFXJIMP Allocation error recovery rou- 
tine. 
IEFWA000 Demand allocation routine. 
IEFWSWIN Passes control to decision allo- 
cation or AVR routine. 
IEFX5000 Decision allocation routine. 
IEFX300A Device strikeout routine. 
IEFXHOOO Separation strikeout routine. 
IEFWMSKA Device mask table. 
IEFWCIMP Task input/output table (TIOT) 

construction routine. 
IEFWD000 External action routine. 
IEFWD001 Message directory for external 

action routine. 
IEFXTOOD Space request routine. 
IEFXKIMP Allocation error nonrecovery 

routine. 
IEFW41SD Exit to step initiation routine. 
IEFSD004 Step initiation routine, with 

exit to processing program. 
IEFSD006 Convert record number to logical 

track address (TTR) . 
IEFSD007 Call to table store subroutine. 
IEFSD010 Dequeue and write out system 

message blocks (SMBs) . 
IEFXTDMY Queue overflow routine. 
IEFYSSMB Message enqueuing routine. 
IEFQMSSS Table store subroutine. 
IEFXAMSG Contains initiator/terminator 

messages. 
IEFXJMSG Contains initiator/terminator 

messages. 
IEFXKMSG Contains initiator/terminator 

messages. 
IEFXTMSG Contains initiator/terminator 

messages. 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 
IEFS15XL Check for duplicate allocation. 



Load Module Name: IEFCNTRL 
Alias : IEF5DDHD 
Alias : IEFZA 
Alias: IEFSD008 
Alias : IEFMC 
Alias : IEFKA 
Entry Point: IEFKA 
Assembly Modules: 

IEF7KAXX Reader/interpreter control rou- 
tine. 

Scans job control language (JCL) 

statements . 

Breakout routine. 

Qualified name routine. 

Scan stepname routine. 

Verb identification routine. 

Continuation routine. 

JOB statement routine. 

Accounting information routine. 

TYPRUN keyword routine. 

Priority (PRTY) keyword routine. 

Condition (COND) keyword rou- 
tine. 

MSGLEVEL keyword routine. 

MSGCLASS keyword routine. 

Parenthesis routine. 

EXEC statement routine. 



IEF6MCXX 

IEF6BOCM 
IEF6NAME 
IEF6STNM 
IEF6MFXX 
IEF6MKXX 
IEF6NCJB 
IEF6NFCM 
IEF6N1JB 
IEF6NYJB 
IEF6C0ND 



IEF6NXJB 
IEF6NZJB 
IEF6NIJB 
IEF6NJEX 



UU 



IEF6RFBK Refer- back routine. 
IEF6PROC Procedure name routine. 
IEF6TIME TIME keyword routine. 
IEF6PARM Parameter (PARM) keyword rou- 
tine. 

DD statement routine. 

DD scan routine. 

DD* statement routine. 

DD name routine. 

Resolves DD forward references. 

DS name routine. 

Processes DD forward references. 

Left parenthesis routine. 

Right parenthesis routine. 

Equal sign routine. 

Subparameter list routine. 

Routine for no subparameter 

list. 

DD parameter list table. 

DCB refer- back routine. 

DCB DD parameter list table. 

Order subroutine. 

Insert routine. 

Value subroutine. 

Clean up after DD routine. 

DD error- handling routine. 

Processes command in input 

stream. 

Master command routine. 

Reader/interpreter message rou- 
tine. 

Reader/interpreter call to table 

store subroutine. 

Table store subroutine. 

Output tables for step. 

Assigns unit for system output 

(SYSOUT) . 

Initiator/terminator- to 

reader/interpreter interface 

routine. 

Reader/interpreter entry to 

IEF09FAK or to IEFW23SD (both in 

this load module) . 

Performs initialization for job 

termination routine and exits to 

IEFZAJB3 (in this load module) . 

Job termination routine. 

Job ended message routine. 

Disposition and unallocation 

subroutine. 

Linkage to user accounting rou- 
tine. 

Dummy routine to be replaced by 

user's accounting routine. 
(The preceding two modules may be replaced 
by IEFACTFK assembly module if no account- 
ing routine is specified as a system gener- 
ation option . ) 
IEFYSSMB Message enqueuing routine 

enqueues SMBs. 
IEFW31SD Job termination exit to IEFSD003 

(in this load module). 
IEFSD003 Passes control to IEFSD010, then 

goes to IEFSD008 (both in this 

load module) . 
IEFSD006 Converts record number to logi- 
cal track address (TTR) 



IEF6DDHD 
IEF6SCAN 
IEFSD012 
IEF6DDNM 
IEF6FRRS 
IEF6DSNM 
IEF6RFWD 
IEF6LFPR 
IEF6RTPR 
IEF6EQUL 
IEF6LIST 
IEF6NLST 

IEF6NDDP 
IEF6DCB0 
IEF6DCDP 
IEF60RDR 
IEF6INST 
IEF6VALU 
IEF6CLNP 
IEF6ERR1 
IEF7KPXX 

IEEMCS01 
IEF7MMCM 

IEF6MIXX 

IEFQMSSS 
IEF7KGXX 
IEFSD013 

IEFSD008 



IEFSD001 



IEFW23SD 



IEFZAJB3 
IEFWTERM 
IEFZGJB1 

IEFACTLK 

IEFACTRT 



IEFSD010 Dequeue and write out system 

message blocks (SMBs) . 
IEFZHFAK Linkage to subroutine ZP0QMGR1. 
IEFZGMSG Contains initiator/terminator 

messages . 
IEFZHMSG Contains initiator/terminator 

messages. 
IEEILCDM Prevents unresolved IEEICCAN 

symbol after IPL time. 
IEFK4DUM Linkage to IEFK4ENT (in IEFNEWRD 

load module) . 
IEF09FAK Linkage to IEFSD009 (in IEFSTERM 

load module) . 
IEF8LINK Linkage to IEF6C0ND (in this 

load module) . 
IEFKLDUM Linkage to IEF6KLXX (in IEF1STMT 

load module) . 
IEF60UT2 Linkage to IEF6SCAN (in this 

load module) . 
IEFK3DUM Linkage to IEF7K3XX (in IEFEOF 

load module) . 
IEFSD035 Check for downshift (exit to 

IEFSD031). 

Load Module Name: IEF1STMT 

Alias : IEFKL 

Entry Point: IEFKL 

Assembly Modules: 

IEF6KLXX First statement routine. 

IEF7MMCM Reader/interpreter message rou- 
tine. 

IEF6MIXX Reader/interpreter call to table 
store subroutine. 

IEFQMSSS Table store subroutine. 

IEFMCDUM Linkage to IEF6MCXX (in IEFCNTRL 
load module) . 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

Load Module Name: IEFEOF 

Alias : IEFK3 

Entry Point: IEFK3 

Assembly Modules: 

IEF7K3XX Input stream end-of-file (EOF) 
routine. 

IEF7K4XX Close devices routine. 

IEF7K2XX Open devices routine. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEFSD007 Call to table store subroutine. 

IEF6MIXX Reader/interpreter call to talble 
store subroutine. 

IEFQMSSS Table store subroutine. 

IEEMCS01 Master command routine. 

IEEILCDM Prevent unresolved IEEICCAN 
symbol after IPL. 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 



Load Module Name: IEFK4 

Entry Point: IEFK4DUM 

Assembly Modules: 

IEFK4ENT 

IEF7K4XX 

IEF7K2XX 

IEFSD006 



IEFSD007 



Call to table store subroutine. 



IEFSD007 



Switch input readers routine. 

Close devices routine. 

Open devices routine. 

Convert record number to logical 

track address (TTR) . 

Call to table store subroutine. 
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IEF6MIXX Reader/interpreter call to table 

store subroutine. 
IEFQMSSS Table store subroutine. 



IEF3MSG7 Contains reader/ interpreter 
messages. 



Load Module Name; IEFERROR 

Alias : IEFVM6LS 

Entry Point: IEFVMSGR 

Assembly Modules: 

IEFVMLS6 JFCB housekeeping error message 

processing routine. 
IEFYSSMB Message enqueuing routine , 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFVMLS7 Contains initiator/terminator 

messages 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFIDUMP 

Entry Point: IEFIDUMP 

Assembly Modules: 

IEFIDUMP Indicative dump routine. 

IEFYSSMB Message enqueuing routine 9 

enqueues SMBs. 
IEFQMSSS Table store subroutine. 
IEFIDMPM Contains initiator/terminator 

messages. 
IEFYNFAK Linkage to IEFYNIMP (in IEFSTERM 

load module) . 

Load Module Name: IEFDCB 

Alias: IEF5DCDP 

Assembly Module: 

IEF6DCDP DCB DD parameter list table. 

Load Module Name: IEFMSG01 
Assembly Module: 

IEF3MSG1 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG02 
Assembly Module: 

IEF3MSG2 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG03 
Assembly Module: 

IEF3MSG3 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG04 
Assembly Module: 

IEF3MSG4 Contains reader/interpreter 
messages. 

Load Module Name: IEFMSG05 
Assembly Module: 

IEF3MSG5 Contains reader/interpreter 
messages. 



Load Module Name: IEFMSG06 
Assembly Module: 

IEF3MSG6 Contains reader/interpreter 
messages . 

Load Module Name: IEFMSG07 



Assembly Module: 



Load Module Name: IEFINITL 

Alias : IEFK1 

Entry Point: IEFK1 

Assembly Modules: 

IEF7K1XX Entry to job management from 

nucleus initialization program 
(NIP) . 

IEEMCS01 Master command routine. 

IEEILC01 Automatic command routine. 

IEF7K2XX Open devices routine. 

IEFWSDIP Linkage control table (LCT) 
initialization. 

IEFSD006 Converts record number to logi- 
cal track address (TTR) . 

IEFSD007 Call to table store subroutine. 

IEF6MIXX Reader/interpreter call to table 
store subroutine. 

IEFQMSSS Table store subroutine. 

IEFKADUM Linkage to IEF7KAXX (in IEFCNTRL 
load module) . 

Load Module Name: IEESET 
Alias : IEEGESTO 
Assembly Module: 

IEEGES01 Master scheduler SET command 
routine. 

Load Module Name: IEFJOBQE 
Alias: IEFINTQS 
Assembly Module: 

IEFINTQA Initializes SYS1 . SYS JOBQE data 
set. 

Load Module Name: IEETIME 

Alias: IEEQOT00 

Assembly Module: 

IEEQOT00 Sets time and date. 

Load Module Name: IEEFAULT 
Alias: IEEGK1GM 
Assembly Module: 

IEEGK1GM Fault routine, issues master 
scheduler messages. 

Load Module Name: IEESTART 

Alias : IEEIC1PE 

Entry Point: IEEIC1PE 

Assembly Modules: 

IEESTART START command routine. 

IEEREADR Start reader routine. 

IEEWRITR Start writer routine. 

Load Module Name: IEEJFCB 
Alias : IEEIC3 JF 
Assembly Module: 

IEEIC3JF Contains preformatted JFCB for 
one START command. 

Load Module Name: IEESJFCB 

Alias : IEEIC2NQ 

Entry Point: IEEIC2NQ 

Assembly Modules: 

IEEIC2NQ Save JFCBs for START commands. 

IEFQMSSS Table store subroutine. 



1*6 



Load Module Name: IEFSD030 
Assembly Modules: 

IEFSD030 Scheduler downshift routine. 
IEFSD006 Converts record number to logi- 
cal track address (TTR) . 
IEFSD007 Call to table store subroutine. 
IEFSQMSS Table store subroutine. 

Load Module Name: IEFSD031 
Assembly Modules: 

IEFSD031 Scheduler upshift routine. 
IEFSD006 Converts record number to logi- 
cal track address (TTR). 
IEFSD007 Call to table store subroutine. 
IEFSQMSS Table store subroutine. 

Load Module Name: IEFPRINT 

Alias : SPRINTER 

Alias: IEFPRT 

Assembly Module: 

IEFPRTXX Tape SYSOUT to printer. 



ASSEMBLY MODULES AND CONTROL SECTIONS 

The following table shows in which load 
modules each assembly module is used in the 
three configurations of job management. 
The first column lists the assembly module 
names in alphameric order. Except for 
those indicated with asterisks , all assem- 
bly modules are contained in load modules 
in the SYS1.LINKLIB data set. As a system 
generation option, the assembly module IEF- 
ACTFK may replace both IEFACTLK and IEF- 
ACTRT. The second column lists the control 
section names that correspond to the assem- 
bly module names in the first column. The 
next two columns of the table indicate 
which load modules of each configuration 
contain each assembly module. The two 
right-hand columns of the table refer to 
the CHARTS section of the PLM. If a 
particular control section is shown as a 
subroutine block , the flowchart number is 
listed in the SUBR. BLOCK column; if the 
flow within a control section is given in a 
chart, the flowchart number is listed in 
the "Flow is Defined" column. Chart num- 
bers which appear in parentheses refer to 
charts which can be found in the publica- 
tion IBM System/360 Operating System: Job 
Management, Program Logic Manual , Form 
Y28-6613. 



Load Modules and Assembly Modules 47 



Assembly Modules and 
r t t- 



Control Sections 

T 









Load Modules in Which | 


Chart Number 








Assembly Modules are Usedj- 


T 


j Assembly 




Control 


L ^ 




Appears As | Flow is 


r T i 


| Module Name 


j Notes 


Section Name 


18K 


44K 1 


Subr. Block j Defined 


1- 


-+ J 


j 


4 4. 


+ 


| IEEBC1PE 


1 * 


IEEBC1PE 






(02) | 04,(07) 


| IEEBH1PE 


|Not 

|Used 


IEEBH1 


IGC0003F 


IGC0003F | 




| IEECIR01 


j * 


IEEBA1 






(02) | 04,(03) 


j IEECVCTI 




IEECVCTI 


IEECVCTI 


IEECVCTI | 




| IEEGES01 




IEEGESTO 


IEESET 


IEESET j 


(05) | 


| IEEGK1GM 




IEEGK1GM 


IEEFAULT 


IEEFAULT | 


(05,15) | 


| IEEIC2NQ 




IEEIC2NQ 


IEESJFCB 


IEESJFCB j 




j IEEIC3JF 


| ** 


IEEIC3JF 


IEEJFCB 


IEEJFCB | 




| IEEILCDM 




IEEICCAN 


lEFINTFC 
lEFCOMND 
lEFEOF 


IEFCNTRL j 
lEFEOF j 


(05) | 


| IEEILC01 


j ** 


IEEICCAN 


lEFINITL 


lEFINITL | 




| IEEMCR01 




IEEBB1 


lEFINTFC 
lEFCOMND 
lEFINITL 
lEFEOF 


IEFCNTRL | 
lEFINITL | 
lEFEOF j 


10, (02,09) | (05) 


| IEEMXC01 




IGC03D 


IGC0003D 


IGC0003D | 


(02) | 05,(04) 


| IEEMSR01 


j *** 


IGC03D 


IGC0003D 


IGC0003D | 


02(02) j (04) 


| IEEQOT00 




IEEQOT00 


IEETIME 


IEETIME | 




| IEEREADR 




IEEICRDR 


IEESTART 


IEESTART j 




j IEERSC01 


1 * 


IEEMSLT 








j IEERSR01 


1 * 


IEEMSLT 








| IEESTART 




IEEIC1PE 


IEESTART 


IEESTART | 




j IEEVRFRX 




IEEVRFRX 


IEECVCTI 


IEECVCTI | 




| IEEWRITR 




IEECWTR 


IEESTART 


IEESTART j 




j IEEWTC01 




IGC03E 


IGC0003E 


IGC0003E | 


| (06) 


| IEEWTR01 


| *** 


IGC03E 


IGC0003E 


IGC0003E | 


| (06) 


j IEFACTFK 




IEFACTFK 


IEFSTERM 
IEFJTERM 


IEFSTERM | 
IEFCNTRL | 




| IEFACTLK 




IEFACTLK 


IEFSTERM 
IEFJTERM 


IEFSTERM j 
IEFCNTRL j 




| IEFACTRT 




IEFACTRT 


IEFSTERM 
IEFJTERM 


IEFSTERM | 
IEFCNTRL | 


15,(34) | 


| IEFDPOST 


1 * 


IEFDPOST 








j IEFEMDUM 




IEFEM 


IEFCNTRL 






| IEFIDFAK 




IEFIDUMP 


IEFSTERM 


IEFSTERM | 




| IEFIDMPM 




IEFIDMPM 


IEFIDUMP 


IEFIDUMP j 




| IEFIDUMP 




IEFIDUMP 


IEFIDUMP 


IEFIDUMP | 




1 IEFINTQA 




IEFINTQS 


IEFJOBQE 


IEFJOBQE j 




| IEFJMDUM 




IEFJM 


IEFCNTRL 






| IEJKADUM 




IEFKA 


lEFINITL 
lEFEOF 
lEFINTFC 
lEFCOMND 


lEFINITL | 
lEFEOF j 
IEF1STMT | 




| IEFKGDUM 




IEFKG 


IEFCNTRL 






j IEFKLDUM 




IEFKL 


IEFCNTRL 


IEFCNTRL | 




| IEFKPDUM 




IEFKP 


IEFCNTRL 






| IEFKRESA 


* 


IEFJOB 








j IEFK3DUM 




IEFK3 


IEFCNTRL 
lEFINTFC 


IEFCNTRL | 




| IEFK4DUM 




IEFK4 


IEFCNTRL 


IEFCNTRL | 




| IEFK4ENT 




IEFK4DUM 


IEFK4 


IEFK4 j 




j IEFMCDUM 




IEFMC 


IEF1STMT 


IEF1STMT j 




| IEFMFDUM 




IEFMF 


lEFINTFC 

lEFEXEC 

IEFJOB 






| IEFPRTXX 


-±— 


SPRINTER 


IEFPRINT 


IEFPRINT | 

J.- 


J 



(Continued) 



48 



Assembly Modules and Control Sections (Continued) 



r 


"T 


T 


T 








"T" 






"i 










Load Modules in Which 




Chart Number 


1 








(Assembly Modules are Usedf- 






j 






"T"~ ~ 


1 


| Assembly 




| Control 


L 








H 


Appears As 


| Flow is 




r 




T 






j Module Name 


| Notes | Section Name | 


18K 


1 


44K 




Subr. Block 


j Defined 




1- 


-+ — 


— + 


-+- 




+ 




-+- 





-+ 


H 


| IEFQMSSS 




j IEFQMSSS 




lEFSTERM 

lEFSELCT 

lEFALOCl 

IEFALOC4 

lEFATACH 

lEFCNTRL 

IEFDD 

lEFINTFC 

lEFEXEC 

IEFJOB 

lEFJTERM 

lEFCOMND 

lEFlSTMT 

lEFEOF 

IEFK4 

lEFERROR 

lEFIDUMP 

lEFINITL 

lEESJFCB 




lEFSTERM 

lEFALLOC 

lEFCNTRL 

lEFlSTMT 

lEFEOF 

IEFK4 

lEFERROR 

lEFIDUMP 

lEFINITL 

lEESJFCB 




17, (12,16] 


1 | 




| IEFSD001 




| IEFSD001 




lEFINTFC 




lEFCNTRL 




(09) 






j IEFSD002 




j IEFSD002 




lEFSTERM 




lEFSTERM 










| IEFSD003 




j IEFSD003 




lEFJTERM 




lEFCNTRL 










| IEFSD004 




| IEFSD004 




lEFATACH 




lEFALLOC 






| (32) 




j IEFSD006 




| IEFSD006 




lEFSTERM 

IEFALOC2 

IEFALOC4 

lEFATACH 

lEFCNTRL 

IEFDD 

lEFINTFC 

lEFJTERM 

lEFCOMND 

lEFEOF 

IEFK4 

lEFINITL 




lEFSTERM 

lEFALLOC 

lEFCNTRL 

lEFEOF 

IEFK4 

lEFINITL 




(18) 






| IEFSD007 




| IEFSD007 




lEFSTERM 

lEFATACH 

lEFINTFC 

lEFJTERM 

lEFEOF 

IEFK4 

lEFINITL 




lEFSTERM 

lEFALLOC 

lEFCNTRL 

lEFEOF 

IEFK4 

lEFINITL 




(18) 
(17) 






| IEFSD008 




| IEFSD008 




lEFINTFC 




lEFCNTRL 






| (09) 




| IEFSD009 




j IEFSD009 




lEFSELCT 




lEFSTERM 










j IEFSD010 




| IEFSD010 




lEFATACH 
lEFJTERM 




lEFALLOC 
lEFCNTRL 










| IEFSD011 




| IEFSD011 




lEFSTERM 




lEFSTERM 




(14,33) 


| (34) 




j IEFSD012 




| IEFSD012 




IEFDD 




lEFCNTRL 










| IEFSD013 




| IEFSD013 




IEFDD 




lEFCNTRL 










| IEFSD017 


l 


j IEFSD017 




lEFSTERM 




lEFSTERM 










j IEFSD030 




| IEFSD030 




IEFSD030 




IEFSD030 






| 18 




j IEFSD031 




j IEFSD031 




IEFSD031 




IEFSD031 






1 17 




| IEFSD034 




j IEFSD034 




lEFSTERM 




lEFSTERM 






1 13 




j IEFSD035 




| IEFSD035 




lEFJTERM 




lEFCNTRL 






1 16 




| IEFVJIMP 




| IEFVJ 




lEFSTERM 




lEFSTERM 




(34) 


| (35) 




| IEFVJMSG 




| IEFVJMSG 




lEFSTERM 




lEFSTERM 










| IEFVKIMP 




| IEFVK 




lEFSELCT 




lEFSTERM 




(14) 


| (16) 




j IEFVKMSG 




| IEFVKMSG 




lEFSELCT 




lEFSTERM 










j IEFVMLK5 




| IEFVM6 




lEFSELCT 




lEFSTERM 










L 


_X - 


- X - 


X_ 




X. 




-X- 




-X 


_j 



(Continued) 



Load Modules and Assembly Modules 49 



Assembly Modules and Control Sections (Continued) 



r t 


T T 


T - 




1 






Load Modules in Which | 


Chart Number | 






Assembly Modules are Usedj- 


T -i 


j Assembly j 


j Control 






Appears As 


| Flow is | 


^ 


j Module Name JNot 
| IEFVMLS1 | 


:es j Section Name 
| IEFVM1 


18K 


44K | 

I 1- 


Subr. Block 


Defined j 

L J 


lEFSELCT 


r t 
lEFSTERM | 


(17) 


r 1 
| (18) | 


j IEFVMLS6 j 


j IEFVM6 


lEFERROR 


lEFERROR j 


(17 f 18) 


| (24) | 


| IEFVMLS7 j 


| IEFVM7 


lEFERROR 


lEFERROR | 






| IEFVM2LS | 


| IEFVM2 


lEFSELCT 


lEFSTERM | 


(17,18) 


| (20) | 


j IEFVM3LS j 


j IEFVM3 


lEFSELCT 


lEFSTERM j 


(17,18) 


| (21) | 


| IEFVM4LS | 


| IEFVM4 


lEFSELCT 


lEFSTERM j 


(17,18) 


| (22) | 


| IEFVM5LS j 


j IEFVM5 


lEFSELCT 


lEFSTERM j 


(17 f 18) 


| (23) | 


j IEFVM76 | 


| IEFVM76 


lEFSELCT 


lEFSTERM j 






| IEFWAFAK | 


| IEFWAO0O 


lEFALOCl 








j IEFWA000 | 


j IEFWA7 


IEFALOC2 


IEFALLOC | 


(25) 


| '(27) | 


j IEFWCFAK j 


| IEFWC000 


lEFALOCl 
IEFALOC2 








| IEFWCIMP | 


| IEFWC000 


IEFALOC3 


IEFALLOC | 


(25) 


| (29) | 


j IEFWDFAK | 


| IEFWD000 


IEFALOC3 








j IEFWD000 j 


j IEFWD000 


IEFALOC4 


IEFALLOC | 


(25) 


| (30) | 


| IEFWD001 j 


| IEFWD001 


IEFALOC4 


IEFALLOC j 






j IEFWMAS1 | * 


K* | DEVNAMET 


lEFSELCT 


lEFSTERM | 






j IEFWMSKA j * 


** | DEVMASKT 


IEFALOC2 


IEFALLOC j 






| IEFWSDIP | 


j IEFWSDIP 


IEFINITL 


IEFINITL | 






| IEFWSTRT | 


| IEFWSTRT 


lEFSELCT 


lEFSTERM | 






| IEFSWIN | 


j IEFSWIT 


IEFALOC2 


IEFALLOC j 






| IEFWTERM | 


j IEFWTERM 


lEFJTERM 


IEFCNTRL | 






| IEFW21SD j 


j IEFW21SD 


lEFSELCT 


lEFSTERM j 


(14) 


1 <15) | 


| IEFW22SD j 


j IEFW22SD 


lEFSTERM 


lEFSTERM j 


(34) 




| IEFW23SD j 


| IEFW23SD 


lEFJTERM 


IEFCNTRL | 






j IEFW31SD | 


| IEFW31SD 


lEFJTERM 


IEFCNTRL j 






j IEFW41SD j 


j IEFW41SD 


IEFALOC4 


IEFALLOC j 






j IEFW42SD j 


| IEFW42SD 


lEFSTERM 


lEFSTERM | 






j IEFXAFAK j 


j IEFXA 


lEFSELCT 


lEFSTERM j 






| IEFXAMSG | 


| IEFXAMSG 


lEFALOCl 


IEFALLOC | 






j IEFXCSSS j 


j IEFXA 


lEFALOCl 


IEFALLOC j 


(25) 


| (26) | 


| IEFXH000 j 


j IEFXH000 


IEFALOC2 
IEFALOC3 


IEFALLOC j 






| IEFXJFAK | 


| IEFXJ000 


IEFALOC2 
IEFALOC3 








| IEFXJIMP | 


| IEFXJ000 


lEFALOCl 


IEFALLOC | 






| IEFXJMSG | 


j IEFXJMSG 


lEFALOCl 


IEFALLOC j 






| IEFXKIMP | 


| IEFXKOOO 


IEFALOC4 


IEFALLOC | 






| IEFXKMSG | 


j IEFXKMSG 


IEFALOC4 


IEFALLOC j 






| IEFXTDMY j 


j IEFXTDMY 


IEFALOC4 


IEFALLOC | 






| IEFXTMSG j 


| IEFXTMSG 


IEFALOC4 


IEFALLOC j 






j IEFXTOOD | 


j IEFXT000 


IEFALOC4 


IEFALLOC j 


(25) 


i (31) | 


j IEFX300A j 


j IEFX3000 


IEFALOC2 


IEFALLOC j 






| IEFX5000 j 


| IEFX5000 


IEFALOC2 


IEFALLOC j 


(25) 


| (28) | 


| IEFYNFAK | 


j IEFYN 


lEFSELCT 
lEFALOCl 
IEFALOC4 
lEFERROR 
lEFIDUMP 


IEFALLOC | 
lEFERROR j 
lEFIDUMP j 






| IEFYNIMP | 


| IEFYN 


lEFSTERM 


lEFSTERM | 






j IEFYNMSG j 


| IEFYNMSG 


lEFSTERM 


lEFSTERM | 






j IEFYPJB3 | 


j IEFYP 


lEFSTERM 


lEFSTERM j 


(34) 


| (37) | 


j IEFYPMSG | 


| IEFYPMSG 


lEFSTERM 


lEFSTERM j 






| IEFYSSMB | 


| IEFYS 


lEFSTERM 
lEFSELCT 
lEFALOCl 
IEFALOC4 
lEFJTERM 
i lEFERROR 


lEFSTERM j 
IEFALLOC | 
IEFCNTRL | 
lEFERROR j 
lEFIDUMP j 






L X 


x 


L J 


X- 




(Continued) 
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Assembly Modules and Control Sections (Continued) 



I- 



T 


T T 


T - 








Load Modules in Which | 


Chart Number 






Assembly Modules are Usedj-- 






T 


Assembly j 


j Control 




J 


Appears As | Flow is 





Module Name |Noi 
_ i 


:es j Section Name 

X J 


18K 

L X 


44K | 

L X_ 


Subr. Block | Defined 

. X 


- - —j. 


T 1 


r T t 


T 






IEFIDUMP 






IEFZAFAK | 


| IEFZA 


lEFSTERM 


lEFSTERM | 








lEFJTERM 


lEFCNTRL j 


(33) | (36) 


IEFZGJB1 | 


| IEFZG 


lEFJTERM 


lEFCNTRL j 


15,(36) | (38) 


IEFZGMSG | 


| IEFZGMSG 


lEFSTERM 
lEFJTERM 


lEFSTERM | 
lEFCNTRL | 




IEFZGST1 | 


| IEFZG 


lEFSTERM 


lEFSTERM j 




IEFZHFAK j 


j IEFZP0QM 


lEFJTERM 


lEFCNTRL j 




IEFZHMSG j 


j IEFZH 


lEFSTERM 
lEFJTERM 


lEFSTERM j 
lEFCNTRL j 




IEF01FAK | 


| IEFSD004 


IEFALOC4 






IEF08FAK j 


| IEFSD008 


lEFSTERM 
lEFINTFC 
lEFJTERM 


lEFSTERM | 




IEF09FAK | 


| IEFSD009 


lEFSTERM 
lEFINTFC 


lEFCNTRL | 




IEF23FAK | 


| IEFW23SD 


lEFINTFC 






IEF3MSG1 | 


j IEFMSG1 


IEFMSG01 


IEFMSG01 | 




IEF3MSG2 | 


j IEFMSG2 


IEFMSG02 


IEFMSG02 j 




IEF3MSG3 j 


j IEFMSG3 


IEFMSG03 


IEFMSG03 | 




IEF3MSG4 | 


| IEFMSG4 


IEFMSG04 


IEFMSG04 | 




IEF3MSG5 j 


j IEFMSG5 


IEFMSG05 


IEFMSG05 | 




IEF3MSG6 | 


| IEFMSG6 


IEFMSG06 


IEFMSG06 | 




IEF3MSG7 j 


| IEFMSG7 


IEFMSG07 


IEFMSG07 | 




IEF6B0CM j 


j IEFBM 


lEFCNTRL 
IEFDD 
IEFJOB 
lEFEXEC 


lEFCNTRL | 




IEF6CLNP | 


| IEFM02 


IEFDD 


lEFCNTRL | 




IEF6CN17 j 


j INDMRTN 


IEFDD 






IEF6COND | 


j IEF6COND 


lEFEXEC 
IEFJOB 


lEFCNTRL | 




IEF6DCB0 | 


| IEF6DCB0 


lEFCNTRL 


lEFCNTRL | 




IEF6DCDP | 


| INDMB 


IEFDD 
IEFDCB 


lEFCNTRL j 
IEFDCB | 




IEF6DDHD | 


| INDMRTN 


lEFCNTRL 


lEFCNTRL j 


(12) | 


IEF6DDNM j 


| INDM01 


! IEFDD 


lEFCNTRL | 




IEF6DHX1 | 


| INDM0N 


lEFCNTRL 






IEF6DSNM | 


| INDM03 


IEFDD 


lEFCNTRL | 




IEF6EQUL | 


| INDMOP 


IEFDD 


lEFCNTRL | 




IEF6ERR1 j 


j IEF6ERR1 


IEFDD 


lEFCNTRL | 




IEF6FRRS j 


| IEF6FRRS 


lEFCNTRL 


lEFCNTRL j 




IEF6INST | 


j INDMOZ 


IEFDD 


lEFCNTRL j 




IEF6KLXX j 


| IEFKL 


lEFlSTMT 


lEFlSTMT j 




IEF6LFPR j 


| INDM0S1 


IEFDD 


lEFCNTRL j 




IEF6LIST j 


j INDMOY 


IEFDD 


lEFCNTRL j 




IEF6MCXX j 


| IEFMC 


lEFCNTRL 


lEFCNTRL | 


(09) | 


IEF6MFXX j 


j IEFMF 


lEFCNTRL 


lEFCNTRL j 


(09) | 


IEF6MIXX j 


j IEFMI 


lEFCNTRL 

IEFDD 

lEFINTFC 

lEFEXEC 

IEFJOB 

lEFCOMND 

lEFlSTMT 

lEFEOF 

IEFK4 

lEFINITL 


lEFlSTMT j 
lEFNEWRD j 
lEFEOF j 
lEFINITL j 
lEFCNTRL | 




IEF6MKXX | 


| IEFMK 


lEFCNTRL 


lEFCNTRL | 





— X 



(Continued) 
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Assembly Modules and Control Sections (Continued) 



T 


T T 




T - 


-- 1 ----—— — — ■■ ———.—. , , , .... — . 






Load Modules in Which | 


Chart Number 






Assembly Modules are Usedj- 


T 


Assembly | 


| Control 






J 


Appears As | Flow is 





"T 


1 


Module Name |No1 
IEF6NAME | 


^es j Section Name 
| INNAME 


18K 

lEFCNTRL 

IEFEXEC 

lEFJOB 


1 
+ 


U4K | 
lEFCNTRL | 


Subr. Block j Defined 


IEF6NCJB | i 


1=* | IEFJM 


lEFJOB 




lEFCNTRL | 


(08) | (10) 


IEF6NDDP J 


j INDMA 


IEFDD 




lEFCNTRL j 




IEF6NFCM | 


| IEFAM 


IEFEXEC 
lEFJOB 




lEFCNTRL | 




IEF6NIJB | 


| IEFNI 


lEFJOB 




lEFCNTRL | 




IEF6NJEX | 


| IEFEM 


IEFEXEC 




lEFCNTRL j 


(08) | (11) 


IEF6NLST | 


j INDMOX 


IEFDD 




lEFCNTRL j 




IEF6NXJB | 


| IEFNX 


lEFJOB 




lEFCNTRL | 




IEF6NYJB | 


j IEFNY 


lEFJOB 




lEFCNTRL j 




IEF6NZJB j 


| IEFNZ 


lEFJOB 




lEFCNTRL j 




IEF6N1JB | 


j IEFNI 


lEFJOB 




lEFCNTRL | 




IEF60RDR | 


j INDMOV 


IEFDD 




lEFCNTRL j 




IEF60UT2 j 


j INDMOH 


lEFCNTRL 




lEFCNTRL | 


(12) | 


IEF6PARM | 


| IEFPARM 


IEFEXEC 




lEFCNTRL j 




IEF6PR0C j 


j IEFPROC 


IEFEXEC 




lEFCNTRL j 




IEF6RFBK | 


j IEFRFBK 


IEFEXEC 




lEFCNTRL j 




IEF6RFWD | 


j IEF6RFWD 


IEFDD 




lEFCNTRL j 




IEF6RTPR | 


j INDMOR 


IEFDD 




lEFCNTRL j 




IEF6SCAN | 


j INDMON 


IEFDD 




lEFCNTRL | 


(08) | (12) 


IEF6STNM | 


| IEFSTNM 


lEFCNTRL 

IEFEXEC 

lEFJOB 




lEFCNTRL j 




IEF6TIME | 


| IEFTIME 


IEFEXEC 




lEFCNTRL | 




IEF6VALU | 


j INDMOT 


IEFDD 




lEFCNTRL | 




IEF7KAXX j 


j IEFKA 


lEFCNTRL 




lEFCNTRL j 


(09) | 


IEF7KGXX | 


j IEFKG 


lEFINTFC 




lEFCNTRL j 


(09) | 


IEF7KPXX j 


| IEFKP 


lEFCOMND 




lEFCNTRL | 


(09) | 


IEF7K1XX j 


j IEFK1 


IEFINITL 
IEFK4 




IEFINITL j 


(08) | (09) 


IEF7K2XX | 


| IEFK2 


IEFINITL 

IEFK4 

IEFEOF 




IEFINITL | 
IEFK4 | 
IEFEOF | 




IEF7K3XX | 


| IEFK3 


IEFEOF 




IEFEOF j 




IEF7KUXX j 


j IEFK4 


IEFK4 
IEFEOF 




IEFNEWRD j 
IEFEOF j 




IEF7MMCM | 


| IEFWMSG 


lEFCNTRL 

IEF1STMT 

IEFDD 

lEFINTFC 

IEFEXEC 

lEFJOB 

lEFCOMND 




lEFCNTRL j 
IEF1STMT | 




IEF8LINK | 


| IEFLINK 


IEFEXEC 




lEFCNTRL | 




IGC0103D j ** 


** j IGC0103D 


IGC0103D 




IGC0103D | 


(02,04) | 


JL . 


± _ _ J 





.JL. 


A- 


JL 



Notes : 



♦Assembly modules in SYS1. NUCLEUS data set. 
♦♦Modules are assembled at system generation time. 
♦♦♦Assembly modules in SYS1.SVCLIB data set. 
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CONTROL SECTIONS AND ASSEMBLY MODULES 

The following list provides a cross- 
reference between job management control 
section (CSECT) names, which appear in 
alphameric order , and the corresponding 
assembly module names. Control section 
names are also listed in the preceding 
assembly module to load module cross 
reference table. 



CSECT 


Assembly 


Name 


Module Name 


DEVMASKT 


IEFWMSKA 


DEVNAMET 


IEFWMAS1 


IEEBA1 


IEECIR01 


IEEBB1 


IEEMCR01 


IEEBC1PE 


IEEBC1PE 


IEEBH1 


IEEBH1PE 


IEECVCTI 


IEECVCTI 


IEEGESTO 


IEEGES01 


IEEGK1GM 


IEEGK1GM 


IEEICCAN 


IEEILCDM 


IEEICCAN 


IEEILC01 


IEEICRDR 


IEEREADR 


IEEICWTR 


IEEWRITR 


IEEIC1PE 


IEESTART 


IEEIC2NQ 


IEEIC2NQ 


IEEIC3JF 


IEEIC3JF 


IEEMSLT 


IEERSC01 


IEEMSLT 


IEERSR01 


IEEQOT00 


IEEQOT00 


IEEVRFRX 


IEEVRFRX 


IEFACTLK 


IEFACTLK 


IEFACTRT 


IEFACTRT 


IEFAM 


IEF6NFCM 


IEFBM 


IEF6BOCM 


IEFCOND 


IEF6COND 


IEFDPOST 


IEFDPOST 


IEFEM 


IEFEMDUM 


IEFEM 


IEF6NJEX 


IEFIDMPM 


IEFIDMPM 


IEFIDUMP 


IEFIDFAK 


IEFIDUMP 


IEFIDUMP 


IEFINTQS 


IEFINTQA 


IEFJM 


IEFJMDUM 


IEFJM 


IEF6NCJB 


IEFJOB 


IEFKRESA 


IEFKA 


IEFKADUM 


IEFKA 


IEF7KAXX 


IEFKG 


IEFKGDUM 


IEFKG 


IEF7KGXX 


IEFKL 


IEFKLDUM 


IEFKL 


IEF6KLXX 


IEFKP 


IEFKPDUM 


IEFKP 


IEF7KPXX 


IEFK1 


IEF7K1XX 


IEFK2 


IEF7K2XX 


IEFK3 


IEFK3DUM 


IEFK3 


IEF7K3XX 


IEFK4 


IEFK4DUM 


IEFK4 


IEF7K4XX 


IEFK4DUM 


IEFK4ENT 


IEFLINK 


IEF8LINK 


IEFMC 


IEFMCDUM 


IEFMC 


IEF6MCXX 


IEFMF 


IEFMFDUM 


IEFMF 


IEF6MFXX 



CSECT 


Assembly 


Name 


Module Name 


(Cont.) 


(Cont. ) 


IEFMI 


IEF6MIXX 


IEFMK 


IEF6MKXX 


IEFM02 


IEF6CLNP 


IEFMSG1 


IEF3MSG1 


IEFMSG2 


IEF3MSG2 


IEFMSG3 


IEF3MSG3 


IEFMSG4 


IEF3MSGU 


IEFMSG5 


IEF3MSG5 


IEFMSG6 


IEF3MSG6 


IEFMSG7 


IEF3MSG7 


IEFNI 


IEF6NIJB 


IEFNX 


IEF6NXJB 


CSECT 


ASSEMBLY 


IEFNY 


IEF6NYJB 


IEFNZ 


IEF6NZJB 


IEFNI 


IEF6N1JB 


IEFPARM 


IEF6PARM 


IEFPROC 


IEF6PROC 


IEFQMSSS 


IEFQMSSS 


IEFRFBK 


IEF6RFBK 


IEFSD001 


IEFSD001 


IEFSD002 


IEFSD002 


IEFSD003 


IEFSD003 


IEFSD004 


IEFSD004 


IEFSD004 


IEF04FAK 


IEFSD006 


IEFSD006 


IEFSD007 


IEFSD007 


IEFSD008 


IEFSD008 


IEFSD008 


IEF08FAK 


IEFSD009 


IEFSD009 


IEFSD009 


IEF09FAK 


IEFSD010 


IEFSD010 


IEFSD011 


IEFSD011 


IEFSD012 


IEFSD012 


IEFSD013 


IEFSD013 


IEFSD017 


IEFSD017 


IEFSD030 


IEFSD030 


IEFSD031 


IEFSD031 


IEFSD034 


IEFSD034 


IEFSD035 


IEFSD035 


IEFSTNM 


IEF6STNM 


IEFTIME 


IEF6TIME 


IEFVJMSG 


IEFVJMSQ 


IEFVJ 


IEFVJIMP 


IEFVKMSG 


IEFVKMSG 


IEFVK 


IEFVKIMP 


IEFVM1 


IEFVMLS1 


IEFVM2 


IEFVM2LS 


IEFVM3 


IEFVM3LS 


IEFVM4 


IEFVM4LS 


IEFVM5 


IEFVM5LS 


IEFVM6 


IEFVMLK5 


IEFVM6 


IEFVMLS6 


IEFVM76 


IEFVM76 


IEFVM7 


IEFVMLS7 


IEFWAOOO 


IEFWAFAK 


IEFWA7 


IEFWAOOO 


IEFWCOOO 


IEFWCFAK 


IEFWC00O 


IEFWCIMP 


IEFWD000 


IEFWDFAK 


IEFWDOOO 


IEFWDOOO 


IEFWD001 


IEFWD001 


IEFWMSG 


IEF7MMCM 


IEFWSDIP 


IEFWSDIP 


IEFWSTRT 


IEFWSTRT 
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CSECT 

Name 

( Cont. ) 

IEFWSWIT 

IEFWTERM 

IEFW21SD 

IEFW22SD 

IEFW23SD 

IEFW23SD 

IEFW31SD 

IEFW41SD 

IEFW42SD 

IEFXAMSG 

IEFXA 

IEFXA 

IEFXHOOO 

IEFXJMSG 

IEFXJOOO 

IEFXJOOO 

IEFXKMSG 

IEFXKOOO 

IEFXTDMY 

IEFXTMSG 

IEFXTOOO 

IEFX3000 

IEFX5000 

IEFYNIMP 

IEFYNMSG 

IEFYN 

IEFYPMSG 

IEFYP 

IEFYS 

IEFZA 

IEFZA 



Assembly 

Module Name 

( Cont, ) 

IEFWSWIN 

IEFWTERM 

IEFW21SD 

IEFW22SD 

IEFW23SD 

IEF23FAK 

IEFW31SD 

IEFW41SD 

IEFW42SD 

IEFXAMSG 

IEFXAFAK 

IEFXCSSS 

IEFXHOOO 

IEFXJMSG 

IEFXJFAK 

IEFXJIMP 

IEFXKMSG 

IEFXKIMP 

IEFXTDMY 

IEFXTMSG 

IEFXTOOD 

IEFX300A 

IEFX5000 

IEFYNIMP 

IEFYNMSG 

IEFYNFAK 

IEFYPMSG 

IEFYP JB3 

IEFYSSMB 

IEFZAPAK 

IEFZAJB3 



CSECT 

Name 

( Cont, ) 

IEFZGMSG 

IEFZG 

IEFZG 

IEFZH 

IEFZPOQM 

IEF6DCB0 

IEF6ERR1 

IEF6FRRS 

IEF6RFWD 

IGC0103D 

IGC03D 

IGC03E 

INDMA 

INDMB 

INDMOH 

INDMON 

INDMON 

INDMOP 

INDMOR 

INDMOS1 

INDMOT 

INDMOV 

INDMOX 

INDMOY 

INDMOZ 

INDMOl 

INDM03 

INDMRTN 

INNAME 

SPRINTER 



Assembly 

Module Name 

( Cont, ) 

IEFZGMSG 

IEFZGJB1 

IEFZGST1 

IEFZHMSG 

IEFZHFAK 

IEF6DCB0 

IEF6ERR1 

IEF6FRRS 

IEF6RFWD 

IGC0103D 

IEEMXC01 

IEEWTC01 

IEF6NDDP 

IEF6DCDP 

IEF60UT2 

IEF6DHX1 

IEF6SCAN 

IEF6EQUL 

IEF6RTPR 

IEF6LFPR 

IEF6VALU 

IEF60RDR 

IEF6NLST 

IEF6LIST 

IEF6INST 

IEF6DDNM 

IEF6DSNM 

IEF6CN17 

IEF6NAME 

IEFPRTXX 
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CHARTS 



Chart 01. Job Management 



******B2*********** 

* * 

CONSOLE DEVICE 



******B3* ********** 



************* 



*****C2********** 

* 02A1* 
*-*-*-*-*-*-*-*-* 

* *• 

* COMMUNICATION * 

* TASK * 
***************** 



************* 

**** 

* * • 

* C3 *.X. 

* * • 
**** a 

X 
*****C3********** 

* * 
*-*-*-*-*-*-♦_*-* 

.* READER/ * 

* INTERPRETER * 

* * 
***************** 



*****Q3********** 

* 12A3* 
*_*-*-*-*_*-*_*_* 

* INITATOR/ *. 

* TERMINATOR * 

* * 
***************** 



******Q4*********** 



************* 



*****E3** ******** 

* * 

* * 

* JOB STEP *. 

* * 

* * 
***************** 



******E4*********** 

* JOB * 

•X STEP OUTPUT 

* DEVICE * 

************* 



**** 

* * 

* C3 * 

* * 
**** 



Charts 
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Chart 02. Communication Task Control Flow 



****A1 ********* 

* * 

* ENTRY * 

* # 
*************** 



**** A3** ******* 

* * 

* ENTRY * 

* * 
*************** 



****A4********* 

* * 

* ENTRY * 

* * 
*************** 



****A5********* 

* * 

* ENTRY * 

* * 
*************** 



***«*B1 ********** 
♦IEECVCTI 03A2* 
*_*_*-.*_*_*_*_*_* 

* COMMUNICATION * 

* TASK * 
♦INITIALIZATION * 
***************** 



****B2********* 

* * 

* ENTRY * 

* * 
*************** 



*—*—*—*—*—*—*—*—* 
X* MASTER * 
♦COMMAND ROUTINE* 
* (SEE NOTE) * 
***************** 



***************** 



* WRITE-TO- * 

* OPERATOR * 

* ROUTINE * 
***************** 



****C1 ********* 

* * 

* EXIT * 

* * 
*************** 



****C3 ********* 



*************** 



****C4********* 

* * 

* EXIT * 

* * 
*************** 



****C5********* 

* * 

* EXIT * 

* * 
*************** 



TO SUPERVISOR 



TO SUPERVISOR 



****D1 ********* 

* * 

* ENTRY * 

* * 
*************** 



NOTE THE MASTER COMMAND ROUTINE 
IS UNCHANGED FROM THAT OF THE 
SEQUENTIAL SCHEDULING SYSTEM. 
FOR FLOWCHART SEE JOB MANAGE- 
MENT PLM, FORM Z28-6613 



*****E1 ********** 
♦IEEBA1 04A1* 

*-*-*— *—*-*-*-*-L* 

* CONSOLE * 

* INTERRUPT * 

* ROUTINE * 
***************** 



****E4********* 

* * 

* ENTRY * 

* * 
*************** 



FROM COMMUNICATIONS TASK 
INITIALIZATION AFTER IPL 
OR FROM SUPERVISOR 



****F1 ********* 

* * 

* EXIT * 

* * 
*************** 



*****F4********** 
*IEECVCTW 07A2* 
*-*-*-*-*-*-*-*-* 
♦COMMUNICATIONS *- 

* TASK WAIT * 

* ROUTINE * 
***************** 



****F 5* ******** 

* * 

* EXIT * 

* * 
*************** 



SUPERVISOR 



SUPERVISOR 



****G1 ********* 

* * 

* ENTRY * 

* * 
*************** 



*—*—*-*—*—*—*—*-* ♦_*_*_*_*_*_*_*_* 

*ROUTER ROUTINE *........ X* EXTERNAL * 

* * * INTERRUPT * 

* * * PROCESSOR * 
***************** 



***************** 



*- *_*_*- *- *_ *- *- * 

* EXTERNAL * 

* INTERRUPT * 

* ROUTINE * 
***************** 



*****H3********** 
♦IGC03D 05A1* 
*_*-*-*-*-*_*_*_* 

* COMMAND *X 

* PROCESSOR * 

* * 
***************** 



*****H4********** 

♦IEECVPM 10A2* 

*-*-*-*-*-*-*-*-* 

X* *X 

* PROCESSOR * 

* ROUTINE * 
***************** 



****J1 ********* 

* * 

* EXIT * 

*************** 



*****J4********** 
*IEECVOC 11 A3* 
*-*-*-*-*_*-*_*-* 

* *. 

* OPEN/CLOSE * 

* ROUTINE * 
***************** 



SUPERVISOR 
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Chart 03. Communication Task Initialization Routine 



IEECVCTI 

****A2********* 

* * 

* ENTER * 

* * 
*************** 



*****B2********** 

* PLACE * 
♦POINTER TO UCM * 

* IN * 

* COMMUNICATION * 

* VECTOR TABLE * 
***************** 



THE UNIT 
CONTROL MODULE 
(UCM) CONTAINS 
DATA NECESSARY 
TO COMMUNICATION 
TASK OPERATION 



*****C2********** 
♦IEEVRFRX * 
*_*_*_*_*_*_*_*_* 

* CONV DEV NMS *- 
*IN UCM ENTRIES * 

* TO UCB ADDR * 
***************** 



*****C3********** 

* MARK UCB AS * 

* PRIMARY OR * 
X* ALTERNATE * 

* ACCORDING TO * 

* UCM FLAG * 
***************** 



*****D2* ********* 

* BUILD * 

* EVENT * 
♦INDICATION LIST* 

* (EIL) ♦ 

* * 
***************** 



THE EIL IS 
PART OF THE 
UCM AND CONTAINS 
POINTERS TO 
ECB'S + UCB'S. 
THE ECB POINTERS 
FORM THE LIST 
WAITED ON BY 
IEECVCTW 



****E2********* 

* ♦ 

* RETURN * 

* * 
*************** 
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Chart 04. Console and External Interrupt Routines 



CONSOLE 

INTERRUPT 

ROUTINE 

IEEBA1 

****A1 ********* 

* * 

* ENTRY * 

* * 
*************** 



EXTERNAL 

INTERRUPT 

ROUTINE 

IEEBC1PE 

****A3********* 

* * 

* ENTRY * 

* * 
*************** 



**B1******* 

* * 

* POST * 
* COMMUNICATION * 

* TASK * 

* * 
*********** 



**B3******* 

* * 

* POST * 
COMMUNICATION 

* TASK * 

* * 
*********** 



*****C1 ********** 

* * 

* FLAG DEVICE * 

* ENTRY IN UNIT * 
♦CONTROL MODULE * 

* * 
***************** 



****C3 ********* 

* * 

* EXIT * 

* * 
*************** 



****D1 ********* 

* * 

* EXIT * 

* * 
*************** 
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Chart 05. Master Command EXCP Routine 



IGC03D 

****A1 ********* 

* ENTRY * 

* * 
*************** 



*. REQ COMMAND .*. 



*****B2******* 

* * * 

* TURN ON * * 
•X*COMMAND PENDING*.. • • X* 

* SWITCH * * 

* * * 
************** 



*. SET COMMAND •*. 



♦•START COMMAND.*. ..... ..X*. 



START 
(BLANK) 
COMMAND 



*****E1 ********** 

* XCTL TO * 

* COMMAND * 

* PROCESSING * 

* ROUTINE * 

* (IGC0113D) * 
***************** 

**** 



**** 

****F1 ********* 

* * 

* EXIT * 

* * 
*************** 



* TURN OFF * 
♦COMMAND PENDING*. 

* SWITCH * 

* * 
************** 



.* IS MASTER *. NO * 

. X*COMMAND RTN IN.*....X* 

*. STORAGE .* * 



**F3*»****« 



* 




♦ 




*♦♦* 


* 


POST 


♦ 


♦ 






MASTER 


*.. 


..X* 


Fl 


♦SCHEDULER 


ECB* 


♦ 




* 




♦ 


♦ ♦♦* 



*********** 



TO SUPERVISOR 
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Chart 06. Write-To-Operator Routine 



IGC0003E 

****A1 ********* 

* * 

* ENTRY * 

* * 
*************** 



WTOR 
*. .* 



* REPLY * 

QUEUE LIMIT 
*• REACHED .* 



*****B3** ******** 

*ENQ * 

*-*-*-WAI T*-*-*-* 

X* UNTIL REPLY * 

* QUEUE ELEMENT * 

* AVAILABLE * 
***************** 



*****C2********** 

* GET, * 

* SETUP, + LINK * 
*IN REPLY QUEUE * 
♦ELEMENT ASSIGN * 

* REPLY ID * 
***************** 



*_*_*_*_*_*_*_*_* 
.* CANCEL * 

* PREVIOUS ENQ * 

* REQUEST * 
***************** 



* WTO * 

QUEUE LIMIT 
*. REACHED .* 



*****F2********** 

*ENQ * 

*-*-*-*-*-*_*_*-* 

X* WAIT UNTIL * 

* QUEUE ELEMENT * 

* AVAILABLE * 
***************** 



*****G1 ********** 

* * 

* GET, SETUP, + * 

* LINK IN WTO * 

* QUEUE ELEMENT * 

* * 
***************** 



*****H2********** 

*DEQ * 

*-*—*-*-*-*-*_*-* 

X* CANCEL * 

* PREVIOUS ENQ * 

* REQUEST * 
***************** 



WTOR 
**. .** 



*****J2********** 

* * 

* MOVE * 
•X* REPLY ID INTO * 

* MESSAGE * 

* * 
***************** 



*****K1 ********** 

* * 

* MOVE WTO MSG * 
♦INTO WTO QUEUE *. 

* ELEMENT * 

* * 
***************** 



**K2******* 

* POST * 
* WTO/WTOR * 

* REQUEST FOR * 
♦COMMUNICATION* 

* TASK * 
*********** 



****K3********* 

* * 

* RETURN * 

* * 
*************** 
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Chart 07 • Communications Task Wait Routine 



IEECVCTW* 

****A2********* 

* * 

* ENTER ♦ 

* * 
*************** 



*****B2********** 
♦IEECVCTI 03A2* 

* LINK * 
*TO INIT. COMM. * 

* TASK * 
***************** 



**C2******* 

* * 

* WAIT FOR 
* EVENT 

* COMPLETION 

* * 
*********** 



10 COMPLETION 



**D2******* 

* * 

* SVC72 * 
.♦PROCESS POSTED 

* EVENT * 

* * 
*********** 



IEECVCTW NEVER TERMINATES 



Charts 
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Chart 08. Communications Task Router Routine 



IEECVCTR 

****A3* ******** 
» * 

* ENTRY * 

* * 
*************** 



****B4********* 

* XCTL * 

* TO IEECVCTX * 

* * 
*************** 



C3 *. 
• *ANY I/O*. 
.♦COMPLETION * 
*. ECB POSTED 



*****C4********** 

* * 
♦SET UP POINTERS* 

•X* FOR PROCESSOR *. 

* MODULE IN XSA * 

* * 
***************** 



****C5********* 

*XCTL TO IEECVPM* 

X* PROCESSOR * 

* MODULE * 

*************** 



*****E4********** 

* LOCATE * 

* CURRENTLY * 
.X* ACTIVE WTO/R * 

* DEVICE * 

* * 
***************** 



*****F4********** 



***************** 



***************** 



****G2********* 

* RETURN * 

* TO IEECVCTW * 

* * 
*************** 



****G4********* 

* RETURN * 

* TO IEECVCTW * 

* * 
*************** 
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Chart 09. External Interrupt Processor Routine 



*****C2********** 



************** 



*****D2********** 



***************** 



IEECVCTX 

****A3* ******** 

* ENTRY * 

* * 
*************** 



*****B3********** 



***************** 



* DEVICE 

ACTIVE AND 
*• OPEN 



*• LAST DEVICE 



****E2********* 

* XCTL TO * 
•PROCESS MOD. TO* 

* CLOSE * 
*************** 



#****E3»* ******** 



***************** 



*****F3********** 

* FLIP * 

* DEVICE * 
♦ACTIVE/INACTIVE* 

* FLAG * 

* * 
***************** 



LAST DEVICE 



*****H3********** 



***************** 



****J3********* 

* * 

* RETURN * 

* * 
*************** 



Charts 



63 



Chart 10. Communications Task Processor Routine 



IEECVPM 

****A2********* 

* * 

* ENTRY * 

* * 
*************** 



*****B1 ********** 
♦IEECVOC HA3* 
*_*_*-*_*_*_*_*_* 



* OPEN/CLOSE 

* ROUTINE * 
***************** 



*X.... ....*. CLOSE REQUEST.* 



*****B4 ********** 



***************** 



*****B5********** 



***************** 



*****C4********** 

* * 

* INITIALIZE * 

* INPUT CHANNEL * 

* PROGRAM * 

* * 
***************** 



*****C5********** 

* * 

* INITIALIZE * 
♦OUTPUT CHANNEL * 

* PROGRAM * 

* * 
***************** 



****01 ********* 

* * 

* RETURN * 

* * 
*************** 



*****D4********** 

* * 

* * 

* SET BUSY FLAG * 

* * 

* * 
***************** 



*****E2********** 

* * 

* CLEAR * 

* I/O COMPLETE * 

* ECB * 

* * 
***************** 



**E4******* 

* * 

EXCP 

* * 
*********** 



*****F1 ********** 
♦IEEBB1 * 

*—*—*—*—*—*—*—*-* 

* COMMAND *X 
♦PROCESSOR (SVC * 

* 34) * 
***************** 



****F4** ******* 

* * 

* RETURN * 

* * 
*************** 



*****G1 ********** 



*****G2********** 



***************** 



***************** 



*****H1 ********** 
*IEECVOC 11A3* 
*_*_*_*_*_*_*_*_* 

* *X 

* OPEN/CLOSE * 

* ROUTINE * 
***************** 



**** 
S * * 
«.X* B4 * 
* * 

**** 
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Chart 11. OPEN/CLOSE Routine 



IEECVOC 

**** A3 ********* 

* * 

* ENTRY * 

* * 
*************** 



**B4******* 

* * 

CLOSE DCB 

* * 
*********** 



*****C3********** 

* * 

* INITIALIZE * 
*DCB. UCM, ETC, * 

* FOR OPEN * 

* * 
***************** 



*****C4********** 



ADJUST UCM 



***************** 



**D3******* 

* * 

OPENJ 

* * 
*********** 



****D4********* 

* XCTL TO * 

* EXTERNAL * 

* PROCESSOR * 
*************** 



*****E3********** 

* * 

* ADJUST UCM * 
♦TO REFLECT OPEN* 

* STATUS * 

* * 
***************** 



****F3 ********* 

* XCTL * 

* TO PROCESS * 

* MODULE * 
*************** 
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Chart 12 • Initiator/Terminator Control Flow 



****A3** ******* 

* * 

* ENTRY * 
» * 

*************** 



*****B3 ********** 

* * 

* * 

* INITIATOR * 

* CONTROL * 
***************** 



*****C3*** ******* 

* * 
*-*_*-*-*-*-*-*-* 

* * 
♦ALLOCATION AND * 

* SETUP * 
***************** 



*****D3 ********** 



♦STEP INITIATION* 
* * 

***************** 



****E3********* 

* * 

* EXIT * 

* * 
*************** 



****F3********* 

* * 

* ENTRY * 

* * 
*************** 



• FROM 

.SUPERVISOR 

.OR AN INIT/TERM 

•ROUTINE 



*****G3** ******** 

* 13A1* 

* * 

* TERMINATOR * 

* * 
***************** 



****H3********* 

* * 

* EXIT * 

* * 
*************** 

TO READER/ 
INTERPRETER OR 
INITIATOR CONTROL 
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Chart 13. Pre-Termination Routine (IEFSD034) 



**** A 1 ********* 

* * 

* ENTRY * 

*************** 



PROBLEM PROGRAM HAS COMPLETED 
PROCESSING, JOB IS ATTEMPTING 
TO TERMINATE IN THIS PARTITION 



»*«**B1 ********** 

* ACCESS * 

* PTN'S PRSCB * 
♦THROUGH PNTRIN * 

* CURRENT TCB'S * 

* BBOX * 
***************** 



.* POST *. 
•*FLAG ON ( IS*. N 
*.SCHDLR ASGNO •*• 
*.TO PTN B).* 



*****C2** ******** 

* * 

* ISSUE MSG * 

X* PARTITION * 

* WAITING TO * 

* TERMINATE * 
***************** 



****D1 ********* 

* WAIT ON PTN"S * 
♦SCHDLR-CONTROL *X. 

* ECB * 

*************** 



*****D2********** 

* * 

* ISSUE WAIT * 
•* TO DECREMENT * 

* WAIT COUNT * 

* * 
***************** 



*****E1******* 

* SET * 

* FIRST-TIME * 
*WAITR SWITCH ON* 

* IF COMPLETION* 

* CODE IS 4 * 
************** 



****F1 ********* 

* * 

* EXIT * 

* * 
*************** 
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Chart 14. Termination Control Flow 



****A3******»** 

* * 

* ENTRY * 

* * 
*************** 



*****B3** ******** 
♦IEFSD011 * 
*_*_*_*-.*_*_*_*_*N0 MORE STEPS 

* STEP * * 

* TERMINATION *TO BE RUN 

* ROUTINE * 

***************** 



****C3********* 

* * 

* EXIT * 

* * 
*************** 



TO READER/ 
INTERPRETER OR 
SYSTEM CONTROL 
ROUTINE 



****D3 ********* 

* * 

* ENTRY * 

* * 
*************** 



* JOB *X 

* TERMINATION * 

* ROUTINE * 
***************** 



****F3 ********* 

* * 

* EXIT * 

* * 
*************** 
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Chart 15. Job Termination Routine 



IEFZA 

****A1********* 

* ENTRY * 

* * 
*************** 



FROM READER/INTERPRETER 

CONTROL ROUTINE OR 

STEP TERMINATION ROUTINE 



2AA100 X 

**B1******* 
♦GETMAIN FOR* 

* REG. SAVE * 
♦AREA. PDQ, AND 

* DISP/UNALOC * 
* WORK AREA * 

*********** 



**** 

* * 
.X* G4 * 

* * 
**** 



*. THERE A PDQ 



* Dl *.X 



**** 
ZAA300 X 

*****D1 ********** 
*IEFZA * 

*_*_*_*_*-*_*_*_* 

* READ * 

* PDQ DIR BLOCK * 

* * 
***************** 



ZAA3150 X 

*****E1 ********** 
♦IEFZA * 

*-*-.*_*_*_*-.*_*-* 
* READ * 
*PDQ ENTRY BLOCK* 



***************** 



* IS DATA *. 
SET ON D.A. . 
*. DEVICE .* 



*****E4******* 



***************** 




**** I 




* * . 




* Fl *.X. 




* * • 




**** X 




AA320 •*. 




Fl *. 




• * *• 


**** 


.* LAST *. NO 


* 


*. PDQ ENTRY .*... 


.X* B4 


*. BLOCK .* 


* 


*. .* 


**** 



•* *• **** 

.* LAST *. NO * * 
*.PDQ DIR BLOCK.*. ...X* Dl * 



**** . 

* * • 

* Hi *.X. 

* * • 
**** • 

ZAA520 X 

*****H1 ********** 
*IEFZG * 

*-*-*-*-*-*-*-*-* 

* JOB * 

* TERMINATE SRT * 

* CLEANUP * 
***************** 



* TURN 


* 


*ON D.A. SWITCH 


* • 


* 


* • 


* * 




************** 






.X..... 




ZAA420 X 




*****F4********** 


♦IEFZG 


* 


*-*_*_*_*-*-*_* 


-* 


* PERFORM DISP 


* 


* AND 


* 


* UNALLOCATION 


* 


***************** 


**** 






* * 






* G4 *.X 






* * 






**** 






ZAA330 X 




*****G4 ********** 


* 


* 


* INCREMENT 


* 


* DATA SET 


* 


* POIf> 


4TER 


* 



***************** 



**J 1******* 

* * 

FREEMAIN 

* * 
*********** 



IEFACTLK 



.*IS THERE A *. YES 
•X*USER'S ACCOUNT.*.... 
*. ROUTINE .* 



*—*—*—*—*—*—*—*—* 
X* USER'S * 

* ACCOUNTING * 

* ROUTINE * 
***************** 



***** 
*16 * 
* Al* 



TO READER/INTERPRETER 
CONTROL ROUTINE AT 
IEFS0008 



TO READER/INTERPRETER 
CONTROL ROUTINE AT 
IEFS0008 
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Chart 16. Shift Count Interrogator Routine (IEFSD035) 



**** a 1 ********* 

* * 

* ENTRY * 

* * 
*************** 



FROM IEFACTLK IF NO USER* 
ACCOUNTING ROUTINE — 
OTHERWISE, FROM IEFACTRT 



*****B1 ********** 
*ACCESS CURRENT * 

* PRSCB THROUGH * 
*M. S. RESIDENT * 

* CONTROL DATA * 

* AREA * 
***************** 



.* SCHEDULER 

*. ALREADY IN 

♦•PARTITION. 

*• .* 



*****C2******* 

* * 

. YES * ZERO OUT * 
•*........X* ANY REMAINING 

X * SHIFT COUNT * 

* * 
************** 



****C3 ********* 

* * 

* EXIT * 

* * 
*************** 



* IS * 

SHIFT COUNT 
*. ZERO •* 



*****E1 ********** 



***************** 



****F1 ********* 

* * 

* EXIT * 

* * 
*************** 
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Chart 17. Scheduler Upshift Routine (IEFSD031) 



****A1********* 

* * 

* ENTRY * 

*************** 



PARTITION B — 



PARTITION A 



RELINQUISHING SCHEDULER CONTROL 
(JOB HAS TERMINATED. SHIFT COUNT 
WAS NON-ZERO) 



*****B1 ********** 
♦FREEMAIN » 
*_*_*_*_*_*_*_*_* 
♦FREE CORE GOT- * 
♦TEN BY TERMINA-* 
* TION ROUTINES * 
***************** 



* GET CORE ♦ 
♦FOR USE BY THIS* 

* ROUTINE * 
***************** 



*****0 i********** 
♦IEFSD007 * 
*-*-*-*-*-*-*-*-* 
♦READ PTN A LCT * 
*SCT, + JCT FROM* 
♦Q-MGR VAR AREA * 
***************** 



*****E1 ********** 
♦IEFQMSSS * 
*_*_*_*_*_*_*_*_* 

* WRITE PTN A * 

* LCT/SCT/JCT * 
♦INTO FIXED AREA+ 
***************** 



****#F1 ********** 
♦FREEMAIN ♦ 
*_*_*_*_*_*_*_*_* 

♦ FREE GOTTEN ♦ 

♦ CORE (EXCEPT ♦ 

♦ JCT) * 
***************** 



*****G1 ********** 

♦ RESET * 
♦POINTER TO PTN ♦ 
♦WITH SCHEDULER ♦ 

♦ CONTROL ♦ 

♦ (SD33LNGH) ♦ 
***************** 



*****H1 ********** 

* MAKE FORMER ♦ 
*PTN B VARIABLE * 

♦ AREA AVAIL TO ♦ 

♦ Q-MGR FOR RE- * 

* ASSIGNMENT * 
***************** 



*****j 1********** 

* POST * 

* SCHEDULER- * 
♦CONTROLLING ECB^ 
♦FOR PARTITION A* 

* * 
***************** 



****K1 ********* 

* WAIT ON PTN * 

* B'S SCHEDULER ♦ 

* CTL ECB ♦ 
*************** 



♦***K2********* 



*************** 



TO IEFSD030 CHART 18 WHEN 
SCHEDULER AGAIN RELEASED 
PARTITION B THROUGH WAITR 
IN PARTITION A. 
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Chart 18. Scheduler Downshift Routine (IEFSD030) 



****A2********* 

* * 

* ENTRY * 

* * 
*************** 



PARTITION A ISSUED WAITR 

PARTITION B — NEXT LOWER- 
PRIORITY PARTITION 



*****B2********** 

* * 

* * 

* INITIALIZE * 

* * 

* * 
***************** 



*****B4********** 
♦IEFQMSSS * 

*-*-*-*-*-*-*-*-* 
X* READ IN * 
♦PARTITION A SCT* 
* AND JCT * 
***************** 



*****C2********** 

* ZERO * 

* OUT PTN B'S * 

* PRSCB EXCEPT * 
♦POST FLAG + ID * 

* * 
***************** 



*****C4 ******* 

* * 

* TURN ON FLUSH* 

* BIT IN * 

* PARTITION A«S* 

* JCT * 
************** 



*-*_*_*-*-*-*—*_* 

* GET 488 BYTES * 

* FOR THIS RTN * 

* < INCL. SCT/JCT)* 
***************** 



*****D4********** 

* * 

* PREPARE * 

* TO WRITE JCT * 

* AND SCT * 

* * 
***************** 



*_*_*-*_*-*_*_*_* 

* READ IN LCT * 

* USED FOR * 

* PARTITION A * 
***************** 



*****E4********** 

* * 

* SAVE POINTERS * 
*TO Q-MGR EXT IN* 

* PTN A»S PRSCB * 

* * 
***************** 



*****F2********** 
♦GETMAIN * 

*-*—*—*-*-*-*—*-* 

* GET CORE FOR * 
♦LCT TO BE USED * 

* FOR PTN B * 
***************** 



*****F4********** 
♦IEFQMSSS * 
*-*-*-*_*-*-*-*-* 
*WRITE PTN B JCT* 

* AND SCT INTO * 

* FIXED AREA * 
***************** 



*****G2********** 
♦BUILD NEW LCT. ♦ 

* SAVE LENGTH, * 

* SRT, + TCB * 

* PTR-, ZERO * 

* REMAINDER * 
***************** 



*****G4********** 
♦FREEMAIN * 

*_*-*-*-*-*-*_*-* 

* FREE 304 OF * 
*488 BYTES (SAVE* 

* JCT FOR R/I ) * 
***************** 



*****H2********** 
♦IEFSD007 * 
*-*-*-*-*-*-*—*—* 
♦WRITE PTN BLCT * 

* INTO Q-MGRS * 

* FIXED AREA * 
***************** 



*****H4 ********** 

* ISSUE * 

* 'PARTITION B * 

* STARTED* * 

* MESSAGE * 

* * 
***************** 



*-*-*-*-*-*-*-*-* 
♦WRITE PTN A LCT+ 

* INTO PTN A * 

♦ VARIABLE AREA ♦ 
***************** 



****J4********* 

* ♦ 

* XCTL * 

* * 
*************** 



*_*_*-*_*-*-*_*_* 

* GET *. 
*TTR FOR JCT AND* 

* SCT * 
***************** 
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Chart 19. Enqueue Service Routine 



IGC056 

****A1 ********* 

♦ * 

♦ ENTRY * 

♦ ♦ 
*************** 



FROM SVC FLIH 



♦ .VALID REQUEST.* X* 



****B2********* 
* 
ABEND * 
* 

*************** 



***** CI ********** 
♦FINDMAJ * 

*_*_*_*_*_*_*_*_* 
X* FIND QCB * 
♦MATCHING MAJOR * 
* NAME * 
***************** 



*****C3* ********* 

* * 

* SET * 
X* 'AVAILABLE* *. 

* RETURN CODE * 

* * 
***************** 



*19 * 
* Bl* 
***** 



*****D3** ******** 

* * 

* SET * 
X* 'AVAILABLE* * 

* RETURN CODE * 

* * 
***************** 



*****E3********** 

* GET STORAGE * 
NONE * AND CREATE * 

.....X* MAJOR QCBt *. 
♦MINOR QCB, AND * 

* QEL * 
***************** 



*****F1 ********** 
*FINDMIN * 

*-*—*_*—*_*-*-*_* 

* FIND QCB * 
♦MATCHING MINOR ♦ 

♦ NAME X ♦ 
***************** 



*****F3********** 

♦ * 

♦ SET ♦ 
X* 'AVAILABLE' *. 

♦ RETURN CODE ♦ 

♦ ♦ 
***************** 



*****G3********** 

* * 

* SET * 
X* 'AVAILABLE' * 

* RETURN CODE * 

* * 
***************** 



*****K1 ********** 
♦FINDQEL * 

*_*_*_*_*_*_*_*_* 

* FIND * 

* QEL MATCHING * 

* MASK * 
***************** 



*****H3 ********** 

* GET * 
NONE * STORAGE AND * 

.....X* CREATE MINOR ♦. 

* GCB AND QEL ♦ 

* * 
***************** 
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Chart 20. Enqueue Service Routine (continued) 



***** 

*20 * 
* Bl* 



*****B3********** 



•* DUPLICATE *. 
*• REQUEST BY 
♦•THIS TASK.* 



.* INQUIRY * 
•X*.(RET EQ HAVE, 
*. USE, OR .* 
*.TEST).* 



***************** 



MUST - 

COMPLETE 

•REQUESTED. 



**C2******* 

* * 

ABEND 

* * 
*********** 



.♦SUPERVISOR *. 

ROUTINE 

♦REQUESTING.* 



*****D3********** 





RET *. YES * 


SET * 


PA 


*AM 'USE" .* X*' 


IN USE' RETURN* 




• * * 


CODE * 



***************** 



*****D4********** 

* SET * 
*MUST - COMPLETE* 

* FLAG (STEP OR *• 
♦SYSTEM) IN QEL * 

* * 
***************** 



***** 

♦ 21 * 

* Bl* 



•SHARED* OR*. 
•EXCLUSIVE* . 
. REQUEST .* 



-*-*—*—*—*—*—*—* 



***************** 



*****F2********** 

* * 

* SET * 
X* 'AVAILABLE* *. 

* RETURN CODE * 

* * 
***************** 



*****G2********** 

* * 

* SET * 
X* 'AVAILABLE' * 

* RETURN CODE * 

* * 
***************** 



*****H2********** 

* * 

* GET * 
X* STORAGE AND *. 

* CREATE QEL * 

* * 
***************** 



***** 
*21 * 
* Bl* 
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Chart 21 • Enqueue Service Routine (continued) 



***** 

♦21 * 

* A4* 



* SCAN RETURN * 

* CODES IN * 
♦PARAMETER LIST * 

* * 
***************** 



* MORE *. YES 

ELEMENTS TO .*.... 
*. PROCESS .* 



. * ALL * 

♦.RETURN CODES 
*. ZERO .* 



*****C4** ******** 

♦ SET ♦ 

♦ GPR15 TO ♦ 

♦ ADDRESS OF ♦ 
♦PARAMETER LIST ♦ 

♦ * 
***************** 



*****C5* *******♦♦ 



***************** 



*****D1 ********** 

♦ ACCESS ♦ 

♦ TOP PARAMETER ♦ 

♦ ON LIST, USE ♦ 

♦ FOR REMAINING * 

♦ TESTS ♦ 
***************** 



****04********* 

* ♦ 

* RETURN ♦ 

* ♦ 
*************** 



♦ SVRB 

WAIT COUNT 
♦. ZERO . 



♦ SAVE ♦ 
•X+ REGISTERS IN ♦. 

♦ TCB ♦ 

♦ * 
***************** 



*****E3+ ********* 

♦ ♦ 
*SET RESUME PSW * 

. X+ TO SMC ADDR. ♦ 

♦ NEW TO GPR15 * 

♦ ♦ 
***************** 



****F3+^ ♦♦♦♦♦♦♦ 

* * 

* EXIT * 

* ♦ 
*************** 

TO DISPATCHER 



*****H l ********** 

♦ ♦ 

♦ SET ON 'STEP ♦ 
♦MUST COMPLETE' * 

♦ FLAG IN TCB ♦ 

♦ ♦ 
***************** 



♦SET ON 'SYSTEM ♦ 
♦MUST COMPLETE' * 

♦ FLAG IN TCB ♦ 

♦ ♦ 
***************** 



*-*-*-*-*-*—*-*_* 

♦ SET TCB ♦ 
*DISPATCHABILITY* 

♦ AS REQUIRED ♦ 
***************** 



♦ DEFER ♦ 

♦ ASYNCHRONOUS *. 

♦ EXITS ♦ 

♦ * 
***************** 



X+ CHECK ♦ 
♦AND SET RETURN ♦ 
♦ CODES ♦ 
***************** 
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Chart 22. Must Complete Routine 



***************** 



STEP MUST 

COMP. 

.REQUESTED. 



****C2********* 

* * 

* RETURN * 

* * 
*************** 



* GET FIRST * 

* PARTITION TCB * 

* ADDRESS * 

* * 
***************** 



* El *.X. 

* * . 
**** X 



.* SET MUST *. 

COMP. 

♦.REQUESTED.* 



*****E2********** 

* SET * 

* TCB * 
•X* DISPATCHABLE * 



***************** 



*****F1 ********** 

* * 

* SET TCB * 

* NON- *. 

* DISPATCHABLE * 

* * 
***************** 



*****F2********** 

* * 

* GET * 
•X+NEXT PARTITION * 

* TCB * 

* * 
***************** 



*****G3* ********* 

* * 

* GET * 
. X*REQUESTING TCB * 

* ADDRESS * 

* * 
***************** 



**** 

* * 

* El * 

* * 
**** 



*****H3********** 

* * 
♦SET REQUESTING * 

* TCB * 

* DISPATCHABLE * 

* * 
***************** 



****J3 ********* 

* * 

* RETURN * 

* * 
*************** 
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Chart 23. Dequeue Service Routine 



****A1 ********* 

* * 

* ENTRY * 

* * 
*************** 



FROM SVC FLIH 



• * *. 


****B2********* 


•* *. NO 


* 


♦.VALID REQUEST.* 


...X* ABEND 


*. .* 


* 


*. .* 


*************** 


*. .* 




* YES 




**** 




♦23 * 




* CI *.X. 




* * . 




**** . 




PARMLOOP X 




*****C1 ********** 




♦FINDMAJ * 




*_*-*- *-*^*-*_*_* 





* LOCATE MAJOR * 

* QCB * 
***************** 



*****E1 ********** 
♦FINDMIN * 

*_*_*_*_*_*_*_*_* 

* * 

* LOCATE MINOR * 

* QCB * 
***************** 



*****F3********** 

* * 

* * 
. X*SET RETURN CODE* 



***************** 



*****G1 ********** 

* * 

* GET TOP QEL * 
*IN MINOR QCB'S * 

* QUEUE * 

* * 
***************** 



***** 
*24 * 
* F4* 



****G2********* 

* * 
♦ABEND WITH CODE* 

* = 130 * 
*************** 



.* DID *. 
.* DEQ'ING *. N 
.TASK ENQ THIS.*. 
*. QEL .* 



***** 
*24 * 
* Al* 



.* QEL *. EXCL 
•EXCLUSIVE OR •*..... 
*. SHARED .* 



.* END OF *. NO 
QEL QUEUE ,*... 
*. REACHED .* 



**** 

* * 

* F2 * 



END OF *. YES * * 
QEL QUEUE .*.... X* F2 * 
. REACHED .* * * 
*. .* **** 



H4 *. 

•* WAS *. 

(NEXT) QEL 

ENQ'D BY 

. DEQ'ING . 

*.TASK .* 

*• •* 

* YES 



*. RET = HAVE 



*****J5********** 



.*...... ..X*SET RETURN CODE* 



***************** 



QELNEXT .*. 










• *• 


K2 *. 










K3 *. 


• * WAS *. 










* IS *. 


NO .*(NEXT) QEL 


*. 


YES 




.* 


QEL *. EXCL 


...*. ENQ'D BY 




*..... « 


..X* 


.EXCLUSIVE OR .*.... 


*. DEQ'ING .* 






*. SHARED .* . 


♦.TASK .* 










*• .* 


*. •* 










*. .* X 


* 










* SHRD **** 
* 

* H3 






















X * 












***** **** 












*24 * 












* Al* 



****K4********* 

* * 
♦ABEND WITH CODE* 

* = 530 * 
*************** 



♦ 24 * 

* F4* 
* * 
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Chart 24, Dequeue Service Routine (continued) 



***** 

*24 * 
* Al* 



*. RET = HAVE .* 



*****A2********** 

* * 

* SET RETURN * 
X* CODE 00 * 

* (AVAILABLE) * 

* * 
***************** 



*****B1 ********** 
*DECTCB * 

*—*-*-*-*-*—*-*-* 

* DECREMENT * 
♦TCB COUNT FIELD* 

* * 
***************** 



*****C1 ********** 

* * 

* COMPLEMENT * 

* CURRENT QEL * 

* ADDRIF SHARED * 

* * 
***************** 



REMOVE X 

*****Dl ********** 
♦DQELEMENT * 
*-*_*-*_*-*_*-*_* 
♦REMOVE ELEMENT * 

* FROM MINOR ♦ 

* QCB'S QUEUE * 
***************** 



***** 

♦ 24 * 

* E4* 



•* MORE 
• QEL'S ON 
*• QUEUE 



PROCMIN 

*****E2********** 
♦DQMINOR * 

*_*-*_*_*_*_*_*_* 
•••X* REMOVE MINOR *. 

* QCB FROM * 

* MAJOR'S QUEUE * 
***************** 



.* MORE *• YES 
• MINOR QCB'S .*.... 
*.0N QUEUE .* 



NXT INPUT X 

*****E4********** 
♦FREEUP * 

*-*—*-*-*-*-*-*-* 
...X* FREEMAIN FROM * 
X * REMOVED QEL'S * 
* AND/OR QCB'S * 
***************** 



* F4 *.X. 



.* IS NEXT *. EXCL 

*.QEL EXCLUSIVE.* 

*.OR SHARED.* 



PLUSQEL 

*****F2********** 

*DECSVRB 25A1* 

*-*-*-*-*-*—*-*-* 

...X* DECREMENT * 

* SVRB/TASK * 

* SWITCH * 
***************** 



*****F3** ******** 
*DQELEMNT * 
*-*—*-*-*—*-*-*-* 

* REMOVE *. 
♦MAJOR QCB FROM * 

* QUEUE * 
***************** 



* WAS * 

REMOVED QEL 
*. SHARED .* 



*****G4********** 
♦RMCOMP 22B1* 
*-*-*-*-*-*-*-*-* 

* RESET * 

* MUST-COMPLETE * 

* * 
***************** 



*****H1 ********** 
♦DECSVRB 25A1* 
*-*_*-*-*_*_*-*-* 

* DECREMENT * 

* SVRB/TASK * 

* SWITCH * 
***************** 



*****H4********** 
*MCRET2 21A4* 
*_*_*_*_*_*_*_*_* 

* CHECK * 

* FOR RETURN * 

* CODES * 
***************** 



MORE 

QEL»S ON 

QUEUE 



.♦DOES "NEW* * 
. TCB POINTER 
*.EQ. 'OLD'.* 



****J5********* 



*************** 



*****K4********** 



***************** 



****K5********* 

* * 

* EXIT * 

* * 
*************** 

TO DISPATCHER 
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Chart 25. Decrement SVRB/TASK Switch Routine 



***************** 



*.RMC REQUESTED.* 



* IS SVRB 

WAIT COUNT 
*. ZERO 



.* WAS *. STEP 

.SMC SYSTEM OR.* 

*. STEP .* 



*****C1 ********** 



***************** 



*****C3******* 

* TURN * 

* OFF * 

* SYSTEM-MUST- * 

* COMPLETE FLAG* 

* IN TCB * 
************** 



*****C4******* 

* * 

* TURN OFF * 

* STEP-MUST * 

* COMPLETE FLAG* 

* IN TCB * 
************** 



*****03********** 
♦SETRSMC 22D1* 
*-*-*-*-*-*-*-*_* 

* SET TCB'S * 

* DISPATCHABLE * 

* * 
***************** 



.♦TASK'S *. 
.* PRIORITY *. N 
• HIGHER THAN .*. 
♦••NEW TCB.* 



*****E3 ******* 

* * 

* RESET 

* SIRB EXIT 

* SWITCH 

* * 
************** 



*****E4 ********** 

* * 

* ALLOW * 
.X* ASYNCHRONOUS * 

* EXITS * 

* * 
***************** 



*****F1******* 

* SET 'NEW' * 

* TCB POINTER * 
*TO ADDR OF TCB * 

* ENQUELLED ON * 

* RESOURCE * 
************** 



****F4 ********* 

* * 

* EXIT * 

* * 
*************** 

TO CALLING ROUTINE 



****G1 ********* 

* * 

* EXIT * 

* * 
*************** 

TO CALLING ROUTINE 
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Chart 26. ENQ/DEQ Validity Check Routine 



****A1 ********* 



*************** 



SYSTEM TASK .*... X* 



****B2********* 
* 
EXIT * 
* 

*************** 

TO CALLING ROUTINE 



****C2********* 

•X*ABEND WITH CODE* 
* = 33X * 
*************** 



Dl *. 

•* PARAM *. 

* LIST IN * 

CALLING 

*. PARTI- .* 

* . T I ON . * 



****D2********* 

* * 
.X*ABEND WITH CODE* 

* = 43X * 
*************** 



note: value of x 
in abend code is 

IF ERROR 

ON ENQ 

8 IF ERROR 

ON DEQ 



CHKFRNT .*. 

El *. 
.* *. 
.* MAJOR AND *. NO 


INVALID 

****E2********* 
* * 


*. IN PRTN .* 

*. •* 

*. .* 

* 


X * = 43X * 
. *************** 

**** 

* * 

* E2 * 

* * 
**** 



Fl *. 
.* *. ****F2********* 

* MINOR *. NO * * 

NAME LENGTH .* X*ABEND WITH CODE* 

*. VALID .* * = 23X * 

*. .* *************** 



ALL 
REQUESTS 
. CHECKED 



*****H1 ********** 



***************** 



H2 *. 

.* PARAM *. 

.* LIST * 

♦.EXTENDS PAST 

*. CALLING .* 

*.PRTN .* 

*. •* 

* NO 



****J2********* 

* * 

* EXIT * 

* * 
*************** 

TO CALLING ROUTINE 
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Chart 27. 18K Configuration Load Module Control Flow 



****A2********* 
* * 

♦ENTRY FROM NIP * 



****A5********* 
* ENTRY * 
*FROM SUPERVISOR* 



*****81**********L0AD 
*IEFDCB *AND 

*—*_*—*_*_*-*— *_*DELETE 

* DCB *X. 

* REFERENCE * 

* ROUTINE * 
***************** 



_*—*—*—*_ 



-*—*—* 



* READER/INTRPR * 
♦INITIALIZATION * 

♦ ROUTINE ♦ 
***************** 

• XCTL 



*****B4 ********** 
♦IEFIDUMP *X 
*-»*_*_*_*_*_*_*-* 

♦ ♦ 
♦INDICATIVE DUMP* 

♦ ROUTINE ♦ 
***************** 



••♦-♦-♦-♦-♦-♦-♦-♦-♦ 
♦JOB MANAGEMENT ♦ 

..♦INTERFACE, STEP*X. 
♦TERMINATION RT ♦ 

. x*********** ****** 



NOTE 2 
*****C i ********** 
♦IEFMSG01-07 * 
*-*-*_*-*-*-*-*-* *_*_*_*_*_*_*_*_* 

* *X * READER/INTRPR * 

* MESSAGES *LOAD AND *CONTROL AND DD * 

* ♦DELETE ♦ ROUTINES ♦.. 
***************** ***************** 

XCTL . X XCTL 



***#*C3********** XCTL *****C4********** 

..*IEFINTFC *X *IEFJTERM * 

*_*_*_*_*_*_*_*_* *_*_*_*_*_*_*_*_* 

* READER/INTRPR * * JOB *X 

* RE-ENTRY * XCTL * TERMINATION *XCTL 
.X* INTERFACE * X* ROUTINE * 

***************** ***************** 

XCTL 

XCTL 



.XCTL 
*****C5********** 
♦IEFERROR * 

*_*_*-*_*_*_*_*_» 

* JFCB * 

* HOUSEKEEPING * 
♦ERROR ROUTINES * 
***************** 

XCTL X 



*****D1 ********** 

♦IEF1STMT ♦ 

*-*-*-*_*-*-*-*-* 

X* FIRST * 

* STATEMENT ♦. 

* ROUTINE * 
***************** 



*****E1 ********** 

♦IEFK4 * 

*_*_*_*_*_*_*_*_* 

X* OPEN AND *. 

* CLOSE DEVICES * 

♦ ROUTINE ♦ 
***************** 



CTL. . .XCTL 
X . 
*****04********** 
♦IEFSELCT ♦-..... 
*_*-*-*-*-*_*_*_* XCTL 

* SYSTEM * 
♦CONTROL ROUTINES 

♦ * 
***************** 



OPERATOR 

ACTION 

PERMITS 

ALLOCATION 

RECOVERY 

AND RETRY 



*****D5********** 

•X*IEFALOCl * 

*-*-*-*-*-*-*-*-* 

* ALLOCATION * 
•X*CONTROL ROUTINE*.. X. 

* * 
. .**************«** 

NO DD X 
STATE- .XCTL . 



*—*—*—*—*— 



-*-*-* 



* DEMAND 

* AND DECISION * 

* ALLOCN RTNS * 
***************** 

• XCTL 



*-*-*_*_*_*-*-*-* 
X* *. 

* JOB ROUTINE * 

* * 
***************** 



NOTE 1 
*****F2*****+**** 
*IEEMCR01 *. 
*_*_*_*_*_*_*_*_* 

* *. 

* COMMUNICATION * 

* TASK *X 
***************** 



LOAD AND 
*****F3**********DELETE *****F4********** 

• X*IEESTART *. X*IEEJFCB * 

*-*-*_*-*_*-*-*-* *_*_*„*-.*_*_*_*_* 

* START * * JFCB'S FOR * 

♦COMMAND ROUTINES LINK ♦ START COMMAND ♦ 
♦ ROUTINE ♦ 
***************** 



*****F 5* ********* 
•X*IEFAL0C3 * 

XCTL+-*-*-*-*-*— *-*-♦ 

* TIOT * 

* CONSTRUCTION * 
XCTL* ROUTINE * 

• ..••***************** 
• XCTL 



♦EXECUTE ROUTINES 
♦ ♦ 

***************** 



*****G3********** 
.X+IEEFAULT ♦ 
*_*_*_*_*-*-*-*_* 
* * 

* FAULT ROUTINE * 

SVC * * 

EXI T***************** 
XXCTL 



*****G4********** 
.X*IEESJFCB * 
*-*-*-*-*_*-*_*_* 
♦INTERFACE WITH ♦ 
.X* TABLE STORE * 
* SUBROUTINE ♦ 
***************** 



*****G5********^ 
♦IEFAL0C4 * 
*-*-*-*-*-*-*-*-* 
♦EXTERNAL ACTIONS 

* AND SPACE ♦. 

♦ REQUEST RTNS ♦ 
***************** 

• XCTL 



*_*-*_*_*-*-*-*-* 
X* *. 

*DD SCAN ROUTINE* 
* * 

***************** 



*****H3 ********** 

♦IEESET *. 

*_*_*_*_*_*_*-*_* LINK *_*_*_*_*_*_*_*_* 

....X* 'SET * * QUEUE * 

LINK*COMMAND ROUTINE* LINK * I NIT I ALIZATION * 

* * ...X* ROUTINE * 

***************** (AT IPL)***************** 
• XCTL 



*_*_*^*_*_*_*_*_* 

* STEP * 

* INITIATION * 

* ROUTINE * 
***************** 

.XCTL 



*****jl ********** 
*IEFCOMND * 

*_*_*_ *_*,.*_*_*_* 
X* SCAN *. 
♦COMMAND ROUTINE* 
* * 

***************** 



*****J3* ********* 

SVC ♦IEETIME ♦ 

EXI T*-*-*-*-*-*-*-*-* 

.....* * 

♦SUPERVISOR TIME+ 

♦ ROUTINE ♦ 

***************** 



*****J5**** ****** 



***************** 



*****K1 ********** 
♦IEFEOF * 

*_*_*_*_*_*-*_*_*. 
X* END OF * 

* DATA SET * 

♦ ROUTINE ♦X 
***************** XCTL 



NOTE 1 THE ASSEMBLY MODULE IEEMCR01 IS INCLUDED 

IN LOAD MODULES IEFINITL, IEFEOF, IEFCOMND, 
AND IEFINTFC. 

NOTE 2 THE MESSAGE MODULES IEFMSG01 THROUGH 
IEFMSG07 CAN BE LOADED AND DELETED BY 
AND ONE OF THE FOLLOWING MODULES, IEFCNTRL, 
IEF1STMT, IEFK4, IEFJOB, IEFEXEC, IEFDD. 
IEFCOMND. AND IEFOF. 



****K5***^ + ^+ + 

* EXIT ♦ 

* TO SUPERVISOR ♦ 

* * 
*************** 
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Chart 28. 44K Configuration Load Module Control Flow 



****A2********* 
* * 

♦ENTRY FROM NIP * 



****A5********* 

* ENTRY * 
*FROM SUPERVISOR* 

♦ * 
*************** 



LOAD 
*****B1********** AND 
*IEFDCB * DELETE 

*_*_*_*_*_*_*,.*_* 

* DCB *X... 

* REFERENCE * 

* ROUTINE * 
***************** 



*—*.—*—*—*—*—*—*—* 

* RDR/INTERP * 
♦INITIALIZATION ♦ 

♦ ROUTINE ♦ 
***************** 

.XCTL 



*****B4********** 
♦IEFIDUMP * 
*-*-*_*-*-*-*-*-* 

* * 
♦INDICATIVE DUMP* 

* ROUTINE * 
***************** 



*****C1 ********** 
♦IEFMSG01 ♦ 
*-*-*-*-*-*-*-*-* 

♦ MESSAGES ♦ 

♦ ♦ 
***************** 

LOAD AND 
DELETE 
(NOTE 2) 



*****C2********** 
..♦IEFCNTRL ♦ 

*_*-*-*_*-*_*_*_* 
..* RDR/INTERP *X 

♦ AND JOB ♦ * 
..♦ TERMINATE ♦ 

***************** 
XCTL 



X XCTL 
XCTL *****C5********+* 

-X+IEFSTERM ♦ 

XCTL *-*-*_*-*-*_*-*-* 

X* INTERFACE AND * 

XCTL ♦ STEP ♦ 

X* TERMINATION * 

***************** 



*****D1 ********** 
♦IEFMSG02 ♦ 
*-*-*-*-*—*-*-*-* 

♦ *X 
» MESSAGES * 

♦ ♦ 
***************** 



*****D2********** 

♦IEF1STMT ♦ 

*-*-*-*-*-*-*-*-* 

X+ FIRST ♦. 

* STATEMENT * 

♦ ROUTINE ♦ 
***************** 



*****D4********** 
*IEFERROR * 
*-*-*-*-*-*_*-*-* 

* JFC3 ♦ 

♦ HOUSEKEEPING ♦ 
♦ERROR ROUTINES ♦ 
***************** 



X XCTL 
*****05++*++++++* 
*IEFALLOC * 
*-*-*-*-*-*-*-*-* 

* * 

* ALLOCATION ♦ 

* * 
***************** 



*****E1 ********** 
♦IEFMSG03 ♦ 
*_*_*_*_*_*_*_*_* 

* +X 

* MESSAGES ♦ 

* * 
***************** 



*****E2********** 
♦IEFNEWRD * 

:_*-*-*-*-*_*_*_* 

OPEN/CLOSE ♦• 
♦DEVICES ROUTINE* 
* * 

***************** 



• X* 



*****F1 ********** 
♦IEFMSG04 * 
*_*_*_ *_ *_ *_ *_ *_ * 

* *X 

* MESSAGES * 

* * 
***************** 



-*—*—*-*—*—* 



***************** 



*****F2********** 

*IEFEOF * 

*-*-*-*-*-*_*_*_* 

X+ END OF ♦• 

♦ DATA SET ♦ 

♦ ROUTINE ♦ 
***************** 

•LOAD AND 
• DELETE 
.(NOTE 2) 



NOTE 1 
*****G3********** 
♦IEEMCROl ♦. 
*-*-*-*-*-*-*-*-* 

* *. 

* COMMUNICATION * 

* TASK *X.. 
***************** 



***+F5+^++*+*++ 

* EXIT ♦ 

* TO SUPERVISOR * 

* * 
*************** 



LOAD 
AND 

DELETE 
*****G4********** *****G5********** 

X*IEESTART ♦ X*IEFJFCB 



-*-* 

* START ♦ 
♦COMMAND ROUTINE* 



_*-*_* 

* JFCB'S FOR * 

* START COMMAND * 

* ROUTINE ♦ 
***************** 



*****H 1 ********** 
♦IEFMSG06 ♦ 

*_*_*_*_*_*_*!_*_* 

♦ *X.. 

♦ MESSAGES ♦ 

♦ ♦ 
***************** 



*****H4********** 

•X+IEEFAULT * 

*_*-*_*-*-*_*_*_* 

* * 

. .♦ FAULT ROUTINE * 



*****H 5* ********* 
•X*IEESJFCB ♦ 

*_*_*_*_*_*_*-*-* 
♦INTERFACE WITH ♦ 
♦ TABLE STORE ♦ 
•X* SUBROUTINE ♦ 
***************** 



*****J1 ********** 
♦IEFMSG07 * 
*-*-*-*-*-*-*-*-* 

* *X 

* MESSAGES * 

* * 
***************** 



THE ASSEMBLY MODULE 
IEEMCROl IS INCLUDED IN 
LOAD MODULES IEFINITLt 
IEFEOF. AND IEFCNTRL 

THE MESSAGE MODULES 
CAN BE LOADED AND 
DELETED BY IEFCNTRL AND 
IEFEOF. 



*****J4********** 
LINK *IEESET 

*-*-*-*-*-*-*-*-* 
SET 



*****J5**** ****** 
♦IEFJOBQE * 
*-*-*-*-*-*_*-*-* 
QUEUE 



♦COMMAND ROUT INE^ . . X+ IN I T I ALI ZATI ON 

♦ * * ROUTINE 

***************** LINK **************** 
.XCTL (AT IPL) 



*-*-*—*-*- 



SVC ♦SUPERVISOR TIME+ 

EXIT ♦ ROUTINE ♦ 

***************** 
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